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PREFACE. . 5. ee ee, 


This manual describes the Network Operating System (NOS), Version 2. NOS controls operation 
of CONTROL paTA® CYBER 180 Computer Systems, Models 810, 830, 835, 840, 845, 850, 855, 860, 
870, 960, 970, 990, 994, and 995; CONTROL DATA CYBER 170 Computer Systems, Models 171, 172, 
173, 174, 175, 176, 720, 730, 740, 750, 760, 815, 825, 835, 845, 855, 865, and 875; CONTROL 
DATA CYBER 70 Computer Systems, Models 71, 72, 73, and 74; and CONTROL DATA 6000 Computer . 
Systems. 


The NOS Reference Set, composed of four separate volumes, describes the external features. of 
NOS 2. ¥ 


AUDIENCE » a . ” 8 


Volume 1, Introduction to Interactive Usage, is written for the novice. ‘ 


Volume 2, Guide to System Usage, is written for the applications or systems programmer who” 
is unfamiliar with NOS. 


Volume 3, System Commands, is written for all NOS users. 6, Pe ante oe 
Volume 4, Program Interface, is written for the Beevienced COMPASS applications programmer 
or systems programmer. 


The reader of each volume should have a knowledge of the material contained in the previous 
volumes. 


ORGANIZATION 


Volume 1, Introduction to Interactive Usage (60459660), shows a user at an interactive 
terminal how to enter, run, and correct programs, and how to create, retrieve, and maintain 
permanent files. Other topics covered include physical terminal connection and login/logout 
procedures. “7°: 

Volume 2, Guide to System Usage (60459670), describes the general concepts of NOS and some 
of the utilities used with NOS. Topics included are job processing, file concepts, 
procedures, magnetic tape processing, Modify, and loading files. This volume is to be used 
as a learning tool and does not contain Ceres oe spe sensor all NOS Reread 
Volume 3, System Commands (60459680), describes the. ‘eynten eemianae that form cha: user 
interface to NOS. ye te 


Volume 4, Program Interface (60459690), describes the COMPASS program interface to NOS... 
Detailed descriptions of function processors and macros available to: COMPASS: user. ike rams‘ 
are included. Sub Gte a od 
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CONVENTIONS 


Technical changes are indicated by bars in the margins. In addition, the following 
notational conventions are used. 


SYSTEM REQUEST AND MACRO FORMATS 


The system request and macro formats in this manual are presented using both uppercase and 
lowercase characters. Uppercase characters must be entered exactly as shown. Lowercase 
characters are to be replaced with the appropriate characters as described in the text. 


The auto recall parameter is a special case. This parameter is shown in uppercase for all 
requests except CIO requests. However, the system processes all non-CIO requests made by 
user programs with auto recall, regardless of whether or not the auto recall parameter is 

specified in the request. The system processes CIO requests with auto recall only if the @ 
auto recall parameter is specified in the request. 


NUMBER BASE NOTATION 
; Decimal “base ‘is used throughout this manual except where otherwise noted. Octal integers 


greater than 7 or less than -7 are written with a subscript 8 or the word octal. Octal base 
is used in the following contexts: 


o ‘Address indices for memory tables and parameter blocks. ®@ 
e. Display code values. 

@ Function codes of macros. 
e _ Numbers of words in memory. 


“ve , Numerical fields in memory. 


Decimal base is used in all program examples except where the BASE OCTAL pseudoinstruction 
or the postradix B is used. @ 


EXTENDED MEMORY 
The forms of extended memory are as follows: 


@ Extended memory for models 865 and 875 and CYBER 180-class machines is unified 
extended memory (UEM) and may also include either extended core storage (ECS), 
extended semiconductor memory (ESM), or STORNET. 


@ Extended memory for model 176 is large central memory extended (LCME), and may also 
include ECS, ESM, or STORNET. 


e Extended memory for all other NOS computer systems is either ECS, ESM, or STORNET. 
STORNET is supported only on CYBER 170 (except model 176) and 180 Computer Systems. 


ECS, ESM, and STORNET are the only forms of extended memory that can be shared in an ECS 


multimainframe complex and accessed by a distributive data path (DDP) or low-speed port 
(LSP) . 
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ECS refers to ECS, ESM, and STORNET. Extended memory refers to all forms of extended memory 
unless otherwise noted. However, when referencing extended memory in the context of an ECS 
multimainframe complex or DDP or LSP access, UEM and LCME are excluded. 


Programming information for the various forms of extended memory can be found in the COMPASS 
Version 3 Reference Manual and in the appropriate computer system hardware reference manual. 
Some of the CYBER 170 Computer Systems share many of the functional and architectural... 
attributes of the CYBER 180 Computer Systems. Specifically, CYBER 170 Models 815, 325, 935, 
845, and 855 fall into this category. It is sometimes convenient to refer to the CYBER 180 
models and these CYBER 170 models collectively. This manual uses the term CYBER 180-class 
machines to refer to this collection. i Re 


MEMORY WORD FORMATS 


The following notations are used in memory word formats: 


e@ Bits of memory words are numbered in decreasing order from left to right, starting 
with 59 on the left and ending with 0 on the right. 


e@e Bytes (12-bit ee of memory words are numbered in increasing order from left 
to right, starting with 0 (byte 0 consists of bits 59 through 48, byte 1 consists of 
bits 47 through 36, byte 2 consists of bits 35 through 24, byte 3 consists OF: bits 

' 23 through 12, and byte 4 consists of bits 11 through 0). 


e Fields that contain only capital letters indicate portions of memory that. contain 
the display code values for those letters. 


@ Diagonal lines (J) indicate a portion of memory that is not used by the system 
and may contain any value. These portions may, however, be used by future versions 
of NOS. 


@ ‘The word ‘reserved’ or the phrase ‘reserved for Control Data’ indicates a portion of 
memory that is either used internally by the system or is reserved for future use. 
The phrase ’reserved for installations’ indicates a portion of memory that each 
installation may use in whatever manner it chooses. 


e A zero indicates a portion of memory that contains all binary zeros. 


CHARACTER SETS . a OTe 


The ASCII character set is used in the examples in this manual. Other NOS-Gompatible 
character sets are described in appendix A. 
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SUBMITTING COMMENTS 


There is a comment sheet at the back of this manual. You can use it to give us your 
opinion of the manual’s usability, to suggest specific improvements, and to report errors. 
If the comment sheet has already been used, mail your comments to: 


Control Data 

Technical Publications ARH219 
4201 Lexington Avenue N. 

St. Paul, MN 55126-6198 


Please indicate whether you would like a response. 


If you have access to SOLVER, an online facility for reporting problems, you can use it to 
submit comments about the manual. When entering your comments, use NS2 as the product 
identifier. Include the name and publication number of the manual. @ 


If you have questions about the packaging and/or distribution of a printed manual, write 
to: 


Control Data 

Literature and Distribution Services ARHLDS 
4201 Lexington Avenue N. 

St. Paul, MN 55126-6198 


You can call (612) 482-3800 or (612) 482-3801, or FAX your inquiry to (612) 482-3813. (If 


you are a Control Data employee, use the Controlnet number 235-3800, 235-3801, or 235- @ 
3813.) 


CYBER SOFTWARE SUPPORT HOTLINE 


Control Data’s CYBER Software Support maintains a hotline to assist you if you have trouble 
using our products. If you need help not provided in the documentation, or find the 
product does not perform as described, call us at one of the following numbers. A support 
analyst will work with you. 


| In United States and Canada 1-800-345-6628 e 
In other locations 1-612-482-3434 


RELATED PUBLICATIONS 


The following manuals contain information directly related to the material presented in this 
volume. 


You might also want to consult the NOS System Information Manual. It is an online manual 
that includes brief descriptions of all NOS and NOS product manuals. You can access this 
manual “by logging into NOS and simply entering the command EXPLAIN. 


These manuals are available through Control Data sales offices or Literature and 
Distribution Services, 4201 Lexington Avenue N., St. Paul, MN 55126-6198. 


Control Data Publication Publication Number 
Binary Maintenance Log (BML) Message Formats 60459940 & 
CDCNET Batch Device User Guide 60463863 @ 
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Control Data Publication 


CDCNET Terminal Interface Usage 


-Common Memory Manager Version 1 Reference Manual 


COMPASS Version 3 Reference Manual 


CYBER Loader Version 1 Reference Manual 


CYBER Record Manager Advanced Access Methods Version 2 


Reference Manual 


CYBER Record Manager Basic Access Methods Version 1.5 


Reference Manual 


Modify Version 1 Reference Manual 


Network Access Method Version 1 
Host Application Programming Reference Manual 


NOS Version 2 Administration Handbook 


NOS Version 


NOS Version 


NOS Version 


NOS Version 


NOS Version 


NOS Version 


NOS Version 


2 


2 


2 


2 
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Analysis Handbook 

Applications Programmer’s Instant 
Diagnostic Index 

Installation Handbook 

Operations Handbook 

System Overview 


Systems Programmer’s Instant 


NOS Version 2 Tape Management System (TMS) 
Site Operations Manual 


NOS Version 2 Tape Management System (TMS) 
User Reference Manual 


60463850 
60499200 
60492600 


60429800 


60499300 


60495700 


60450100 


60499500 
60459840 
60459300 
60459360 
60459390 
60459320 
60459310 


60459270 


60459370 


60463350 


60463110 


Publication Number 


Appendix K contains a comprehensive bibliography of all Control Data publications,related to 


Nos. 


DISCLAIMER 


ey, 


te eee Se 
This product is intended for use only as described in this document. Control Data cannot be 
responsible for the proper functioning of undescribed features or undefined parameters. 
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PROGRAM/SYSTEM COMMUNICATION 1 


The Network Operating System (Nos) allows communication between a CPU program and predefined 
system routines and functions as follows: 


RA+1 system requests to function processors. 
NOS systems texts. 
Macros.f 


Common decks.JT 


These routines enable you to perform complex operations with a minimum of coding. They have 
been thoroughly tested and optimized, and are designed to meet system interface requirements. 


FUNCTION PROCESSORS 


Several 


NOS system routines process user requests. Sections 3 through 11 contain 


descriptions of each function processor, including: 


Identification of the requests (function numbers). 

Systems texts containing macros and symbol definitions needed to issue the requests. 
System macros (or common decks containing macros) available to issue the requests. 
Common decks containing efficient code and macros to issue the requests. 


Information returned from the processor after the requests. 


Following is a list of the NOS function processors whose system request formats are 
described in this manual. 


Processor | Description Section 
ABT Exit processing request ; 1l 
c1o Combined input/output 3 
CKP Checkpoint processor .. 10 
CPM . Control point manager 6 
fRefer to the COMPASS Version 3 Reference Manual for a complete description of how macros 
are defined and used. 
ttRefer to the Modify Version 1 Reference Manual for a complete description of how common 
decks are defined and used. 


60459690 C : 1-1 


Processor Description Section 


CVL Common validation interface processor 11 


DED, DEP Extended memory dump ll 
DMB Binary dump of central memory and extended memory li 
DMD, DMP Central memory dump ll 
DSP File routing 7 
END Program termination request ll 
LDD, LDQ Fast dynamic loading ll 
LDR, LDV Overlay request ll 
LFM Local file manager - 4 
MEM Memory requests il 
MSG . System message procdeéor 11 
PFM Permanent file manager é 5 
~Qac Queue access interface 8 
QFM ; Queue file manager 11 
RCL Recall CPU 11 
RFL Memory requests ll 
RPV Reprieve processing ~ 10 
SFM System file manager ll 
TCS Command translator 10 
TIM Time and date functions 9 
TLX Interactive terminal requests 11 
WCL Recall CPU for a specified time 11 


SYSTEM REQUESTS 


All communication with the system is performed by entering a system request in location 1 
(RA+1) of the field length and executing an exchange jump (XJ) instruction (refer to figure 
E-1). The system then initiates execution of that portion of the system required to satisfy 
the request. There are two types of system requests. 


r) Those that contain all information necessary in RA+l (for example, RCL). 
e Those that require additional areas for parameters or results from the system; for 


example, CIO requires the specification of a file environment table (FET). 
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The format of the 60-bit request is one of the eoutou lag (depending on whether two or three: 
parameters are to be passed). 


S9 


59 


. 40 35 23 : “1 ie} 
ee 2 77, 


17 ie} 


atl 35 
Ee 7 (77 


fff System request name. 
R Auto recall bit. 
Pj »P2.P3 _ Parameters passed to the portion of the system that processes fff. - 


SYSTEM REQUEST PROCESSING 


Whether 
of this 
portion 
(equals 


e program 


a system request communicates with a FET or another parameter block, the first word 
area is usually the status word. Both the system and the user program use the lower 
of this word to communicate the status of the request. When bit 0 is cleared 

0), the system is in control of the request; when it is set (equals 1), the: user 

is in control of the request . 


For example, to write on file ABC, the user program must perform the following steps (if you 


use the 


macro interface described in section 3, the .common decks COMCCIO and COMCSYS perform 


these steps for you). 


te 


26 


Check the status (bit 0 of the first word of the FET, address 2000 in the example) 
of ABC. 


If ABC is busy (bit 0 cleared), the user program must wait until bit 0 is set. This 
is done by issuing a system request to recall eu) or by issuing a RECALL macro 
on the FET. 


When ABC is idle (bit 0 set), the user program must clear bit O and place the 
request in RAtl. 


If other processing can be performed, the user program proceeds. 


If further processing depends upon ABC being completed, the user program must check 
the status word for completion (bit 0 set by the system). 
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To perform this write operation on file ABC, the. user program issues a system request to 
CIO. The following diagram illustrates the program/system control when performing this 
operation. 


User Program Control of ABC System Control of ABC User Program Control of ABC: 
—_——_— 2 | 


——__——eeee_e 


ABC 16 2000 | ABC 16 2000 | ABC 17 


2000 


The user program requests the system The system clears The system sets bit 0 of 
to take control of ABC by clear- RA+1] upon begin- the first word of the 
ing bit 0 of the first word of the ning processing of FET upon completing the 
FET (address 2000) and entering ~ the request. request. 


CIO 2000 in RA+l. 


In many situations, the program cannot proceed until the system request is complete (as in 
steps 2 and 5 when ABC is busy). The user program can prevent further execution until the 
request is complete (bit 0 of the first word of the FET set) by issuing a recall (RCLP) 
request or a RECALL macro on the FET after the CIO request or by specifying the auto recall 
bit on the original CIO request. This reduces the amount of CPU time used by the job. 


If the request in the previous example were issued with auto recall specified, 


RA+1 P is the display code representation of the 


auto recall bit (20g); that is, bit 40 of 
RA+I! is set. : 


2000 


the system would not allow the job to. continue execution until bit 0 of word 2000 is set. 
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The program must perform the following steps to process the request with auto recall (if you 
use the macro interface described in section 3, the common decks COMCCIO and COMCSYS perform 
these steps for you). 


1. Check the status of ABC (bit 0 of word 2000, which is the first word of the FET). 


2. If ABC is busy, wait until bit 0 is set and return to step 1. This can be done by 
issuing an RCLP request or a RECALL macro on word 2000. 


3. Clear bit 0 of word 2000 and place the CIOP request in RAt+l. 


Processing can proceed with the assurance that the previous operation on ABC is completed 
(bit 0 of word 2000 does not have to be checked). 


You should be aware that many system requests require that the auto recall bit be set. This 
is noted in the description of the requests where applicable. 


ISSUING RA+1 REQUESTS 


When a system request is placed in RA+l, the user program should issue an exchange jump 
instruction (XJ) to ensure immediate processing of the request. 


When the system detects a request in RA+l] that can be processed, RAt+l is cleared and. 
processing begins. _ 


The following example illustrates the steps involved in processing a system request. 


1. The user program issues a CIO request on the FET address, without the auto recall 
bit set ,fto RAt. 


2. The user program issues an XJ instruction. 


3. The system immediately accepts the CIO request. The user program begins to execute 
again only after the system has started processing the request. 


4. At the point where the user program requires that the CIO request be completed 
before further instructions are executed, the program issues an RCLP request on the 
FET address. This prevents the user program from continuing until the CIO request 
is completed. 


The user program places the system request in RA+l and executes an XJ instruction. The CPU 
is exchanged to the system program CPUMTR from the user PROB EEA: The system acts upon the 
request immediately. 


If you use the. macros described in this manual, the common deck COMCSYS places the fune tion 
request in RA+l] and issues the XJ instruction for you. 


TIf£ the CIO request in this example were made with the auto recall bit set, step 4 would 
not. be necessary because the user program would not resume execution until the CIO request 
completes. 
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NOS SYSTEMS TEXTS 


The following systems texts are available to you. 


e SYSTEXT. 
e PPTEXT. 

e NOSTEXT. 
e PSSTEXT. 
e ECSTEXT. 


Although other systems texts exist, the macros described in this manual are supported only 
in the systems texts just listed. 


SYSTEXT contains system communication macros that are used by the CPU COMPASS programmer. 
PPTEXT contains symbol definitions used by all system PP routines for intercommunication and 
contains the micro NOSVER as defined in the system OPL common deck COMSVER. NOSTEXT 


contains all system communication macros, micros, and symbol definitions that are found in 
SYSTEXT and PPTEXT. 


In order to use symbol definitions contained 
in a systems text, you must include the COM- 
PASS pseudoinstruction SST in your program. 


PSSTEXT contains macros that are defined on system OPL common decks COMCMAC and COMCCMD, and 


the micro NOSVER defined on system OPL common deck COMSVER (refer to Common Deck Usage in 
this section and to appendix F). 


ECSTEXT contains operation definitions that are defined on common deck COMCECM. These 


definitions provide instructions for interpretive mode reading and writing of extended 
memory (refer to appendix D). 


By selecting the correct systems text (for the applications COMPASS programmer, this is 


usually SYSTEXT and/or PSSTEXT), you can reduce the amount of system resources needed for 
assemblies. ; 


To obtain listings of the systems texts, enter one or more of the following commands after 
accessing the system OPL.f 


MODIFY,Q,CL,CS=0,Z./*EDIT, SYSTEXT 
MODIFY ,Q, CL, CS=0,Z./*EDIT, PPTEXT 
MODIFY ,Q,CL,CS=0,Z./*EDIT , NOSTEXT 


MODIFY,Q,CL,Z./*EDIT, ECSTEXT 


tYour site must control access to the system OPL as required by. the site’s licensing 
agreement. Contact your site analyst to obtain the procedure for gaining access to the 
system OPL. These examples (and all following examples) assume that you have the system 
OPL available with a local file name of OPL. 
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To obtain a listing of PSSTEXT, enter the following commands after accessing the system OPL. 
MODIFY, Z./*EDIT, PSSTEXT 


COMPASS, 1, LO=X. 


MACRO USAGE 


Macros are available for issuing most requests to the function processors. If macros-.are 
not available, you can define your own using the MACRO. pseudoinstruction (refer to the 
COMPASS Version 3 Reference Manual). 


A macro is a predefined sequence of COMPASS statements that can be used in a program. You 
@ can use predefined macros by specifying. the location of the macro definitions to COMPASS | 
with the S or G parameter. For example: ; 


COMPASS, 1,B, S=XYZTEXT. 


This call causes all macro definitions in XYZTEXT to be available for assembly of the 
program. If no S parameter is specified, COMPASS uses the system default system text 


SYSTEXT. The macros described in this manual, unless OENCEMISe noted, are defined in 
SYSTEXT and NOSTEXT. 


common deck must be called into the text of the program (refer to Common Deck Usage in this 
section). If a macro is defined in common deck COMCMAC or COMCCMD, you have the option of 
specifying the alternate systems text PSSTEXT. For example: 


} _ -Some macros are defined in common decks. To assemble programs containing these macros, the 


COMPASS, I,B,S,S=PSSTEXT. 


This makes available all macro definitions in PSSTEXT (that is, those defined in common. 
decks COMCMAC and COMCCMD) as well as all macros in -SYSTEXT for the assembly of the program. 


In addition to the macros available in SYSTEXT, an integer divide operation definition is 
provided for your convenience. Its format is as follows: 


@ IXi Xj/Xk 


The operation divides Xj by Xk and places the result in Xi. . The contents of registers Xj, 
Xk, and B7 are destroyed. 


When a macro parameter refers to an address, the parameter may generally be a register name, 
a relocatable address, an external symbol, or an absolute address. You should consult the 
expansions of the system macros to détermine whether registers can be used with a given 

- macro and, if so,: the optimum use of registers. You are responsible for ensuring that a 
register used ‘as: a parameter contains:only the parameter (for example, if an 18-bit .address 
is specified by an X register, you must in some cases ensure that the upper 42 bits of the 
register are zero). 
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Most NOS system macros and’ common decks preserve the contents of the following registers. 
AO, XO, AS, and X5 
Also, upon exit, the contents of registers Bl and X2 are as follows: 
Bl 1 
X2 FET address (refer to section 2), if a macro specifies the FET address as a parameter 


There are exceptions to these rules; you oe refer to documentation oe a macro or common 
deck when in doubt. 


The contents of the Bl register are assumed to be 1 upon entry only if Fhe: SYSCOM Bl macro 
is called or the race 1 COMPASS pseudoinstruction is defined. 


SYSCOM 

The SYSCOM macro performs ths following functions. 
e Optionally defines the Bl=1 COMPASS pseudoinstruction. 
e Defines system communication symbols. 


If this macro is used, it should be declared before executable statements or common decks 
occur in the program. 


Macro format: 


Location ppetebige Variable 
SYSCOM Bl 
Bl If present, COMPASS pseudoinstruction Bl=1 is defined. 


‘Many system common decks called from macros assume the contents of the Bl register to be 
equal to 1. Other common decks assume Bl is. equal to 1 only if the macro SYSCOM Bl or 
COMPASS pseudoinstruction Bl=1 is defined. If the Bl parameter is not included in the 
SYSCOM call or if there is no SYSCOM call, these common decks then generate additional code 
to set Bl equal to 1. If SYSCOM Bl or the Bl=1l pseudoinstruction is used, it is your 
responsibility to set the Bl register equal to 1. This should be done as the first 
instruction executed in the program. 


The specification of SYSCOM (with or without specifying Bl) also makes available the system 
communication symbols (refer to figure E-1). These are: 


Symbol Value Description 
RA.MTR 1 ‘Address of RAtl. 
ARGR 2. ” Address of the first argument. 


SPPR 278 Special program parameter area (locations 
27g through 47g). 
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Symbol Value : Description 
PGNR 64g Program name (bits 59 through 18). 
ACTR ; 6g Argument count (bits 17 through 0). 
CMUR, RA.CMU 65g Compare/move unit (CMU) available flag 
(bit 359). 
“LWPR ; 65g LWA+1 of the assigned program space (bits 


17 through 0). If Common Memory Manager 

is loaded in your job’s field length, bits 
17 through O contain the complement of the 
LWA+1 of the assigned program space (refer 


, to the Common Memory Manager Reference 
: Manual). 
FWPR 66g FWA of the assigned program space (bits 17 
through 0). 
JOPR © 66g ' Job origin type (bits 35 through 24). 
XJPR, RA.CEJ 66g : Central exchange available (bit 59). This 
: bit is always set. 
CSMR 678 System character set mode flag (bit 59); 
set if 64-character set mode. 
LDRR 678 LDR completion (bit 29). 
CCDR 70g Command image (eight locations). 
LINP 6010 Lines per page; used to format output. 


COMMON DECK USAGE 


‘A system common deck is a COMPASS subroutine or group of macro or symbol definitions that 


have been tested, optimized, and placed on a program library from which you can access them. 


All of the common decks supplied with the system are available to any user who has access to 
the system OPL The OPL is a collection of records of text that can be accessed randomly 
by the Modify utility program. Refer to the MODIFY command in Volume 3, System Commands, or 
to the Modify Version 1] Reference Manual. Normally, the system OPL is available as a direct 
access permanent file and you must issue an ATTACH command before Modify runs. 


Several classes of system common decks exist; however, you need only be concerned with the 
CPU common decks. Documentation of the common decks provided with the system OPL can be 
obtained with the following commands after the system OPL is accessed. 


MODIFY,Z. /*EDIT, CALLCPU 
DOCMENT. 


To obtain a complete listing of the routines, enter the following command. 
MODIFY, Q,CL, CS=NOSTEXT, Z. /*EDIT, CALLCPU 
TYour site must control access to the system OPL as required by the site’s licensing 
agreement. Contact your site analyst to obtain the procedure for gaining access to the . 


system OPL. 
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Appendix F contains a list of the CPU common decks of general interest and describes their 
functions. 


CPU common deck names have the following format. 


COMCxxx 
COM Indicates a common deck. 
c Specifies CPU common deck. 
- XXX | Entry point name (sometimes defined inside the routine as xxx=). 


The typical COMPASS programmer who is writing relocatable programs is generally unaware of 
the common deck interface, and needs only be concerned if a common deck of unique nature 
(for example, the common deck that converts display code to binary representations) is 
required, or if the specified common deck is not on the system library (SYSLIB). Refer to 
appendix F for a list of common decks available in relocatable form on SYSLIB. 


Two common decks (COMCMAC and COMCCMD) are also available on systems text PSSTEXT. You have 
the option of either calling these decks from the system OPL or specifying the alternate 
systems text PSSTEXT as described under Macro Usage, earlier in this section. 

Most system macros require that the common deck related to a function processor be available 
in the program; however, you do not need to specifically call them when assembling 
relocatable programs, since all macros specify entries to common decks as external symbols. 


When the relocatable subroutines are loaded, the routines required at execution time (such 
as LFM= and CIO= ) are loaded from SYSLIB. 


For example, a subroutine uses the following macro. 


READ ABC,R 


This macro requires routines ClO= and SYS= ; however, the READ macro generates: 
RJ =XCIO= 

and CIO= generates: 
RJ =XSYS= 


Since these are flagged as external references (=X), the loader satisfies them from SYSLIB 
if they are not locally satisfied. : 


If a program is not relocatable or if the desired common deck is not on SYSLIB, then a 
system common deck must be accessed from the system OPL. 
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To use a common deck, either insert the Modify directive *CALL in the text of your program, 
use the COMPASS pseudoinstruction XTEXT, or, for a relocatable program, reference the entry 
point as an external so that it is loaded and linked from SYSLIB. 


When using a common deck, you should be 

aware both of the entry and exit conditions 

for the common deck and of which registers 

that deck uses. These are contained in the 
. documentation within each common deck. 


& The following example illustrates the procedure for using the *CALL directive. 


J0B1. 


USER , USERNAM, PASSWRD. 
COPYBR, INPUT ,XF ILE. 
ATTACH,OPL/UN=LIBRARY. 


RFL, 45000. 


MODIFY,Q@,CL. 


. L6O. 
-EOR- 


PROG © 


TME 
OUT PUT 
START 


*CALL 
*CALL 
*CALL 

OBUF 


~EOR- 

*REW IND 

* CREATE 
*EDIT PROG 
-EOI- ° 
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IDENT PROG,TME 
ABS 
ENTRY START 


COPY PROGRAM TO XFILE 
ATTACH OPL 


CALL MODIFY PROGRAM 
LOAD AND EXECUTE COMPASS BINARY 


DECK NAME TO BE EDITED 


BODY OF ABSOLUTE COMPASS PROGRAM 
THAT OUTPUTS THE CURRENT TIME 


CLOCK MACRO REQUIRES 
COMMON DECK COMCSYS 


SYSCOM B1 

ORG 1108 

CON 0 

FILEC OBUF,101B 
SB1 1 

CLOCK TME 

SA5 TME 

BX6 X5 


WRITEO OUTPUT 
WRITER OUTPUT 
ENDRUN 
comcc 10 
COMCWTO 
COMCSYS 

BSS 101B 
END 


XF ILE 
XF ILE 


WRITEO MACRO REQUIRES COMMON 
DECK COMCWTO, WRITER REQUIRES 
COMCCIO, ENDRUN REQUIRES COMCSYS 
MODIFY DIRECTIVES TO INSERT 
SPECIFIED COMMON DECKS 


MODIFY INPUT DIRECTIVES-- 
REPOSITION XFILE TO BOI 
CREATE PROGRAM LIBRARY 

MODIFY DECK PROG 
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After the system OPL is attached, the Modify utility edits the COMPASS deck by inserting the 
common decks in place of the respective *CALL statements. The Q parameter on the MODIFY 
command causes Modify to call COMPASS to assemble the resultant COMPASS program. The CL 
parameter specifies COMPASS list output. The COMPASS listing from this program does not 
contain a listing of the called common decks, since these common decks contain the CTEXT 
pseudoinstruction. Instead, the following is provided. 


ENDRUN 

CTE XT COMCCIO - I/O FUNCTION PROCESSOR. 

CTEXT COMCWTO - WRITE ONE WORD. 

CTEXT COMCSYS - PROCESS SYSTEM REQUEST. 
OBUF BSS 1018 

END 


To have the specified common decks listed in the program, you must use the COMPASS LIST 
pseudoinstruction in the program, or use list options in the COMPASS command. 


The net effect of the *CALL statement is that the text for the specified common deck is 
inserted at that position in the program text. In the previous example, the assembler would 
receive the following text. 


WRITER OUTPUT 
ENDRUN 


Cc I0= PS ENTRY/EXIT 
COMCC IO . 


EQ CI0O= RETURN 


WTO= PS ENTRY/EXIT 


COMCWTO . 


COMCSYS SYS= PS ENTRY/EXIT 
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The procedure for using the COMPASS pseudoinstruction XTEXT to obtain common decks is 
detailed in the following example. , 


JOB2. 
USER ,USERNAM, PASSWRD. ; 7 
ATTACH, OPL/UN=LIBRARY. 


COMPASS. 
LGO. 
-EOR- 
IDENT PROG, TME 
ABS 
ENTRY START 
SYSCOM B1 
~ ORG 1108 
TME CON 0 
OUTPUT FILEC OBUF,101B 
START $B1 1 
CLOCK TME 
SAS T™E 
BX6 x5 
WRITEO OUTPUT 
WRITER OUTPUT 
ENDRUN) 
OPL XTEXT COMCSYS 
OPL XTEXT COMCWTO 
OPL XTEXT COMCCIO 
OBUF BSS 101B 
- END 
-EOI- 


After attaching the system OPL, a call is made to the COMPASS assembler. The XTEXT 
pseudoinstruction provides a means of obtaining source statements from a file other than 
that being used for input. COMPASS transfers the text from the external source and 
assembles it before taking the next statement from the program. 


. A COMPASS listing from a program using the XTEXT pseudoinstruction also.does not list the 


inserted common decks. These can. be obtained with the COMPASS LIST pseudoinstruction or by 
using list options on the COMPASS command. 


A conflict of tags is one problem that may arise when using common decks. Since all tags 
and routine names within common decks conform to the NOS programming specifications (refer 
to appendix I), each routine name relates to its particular function. Normally, all system 


common decks are automatically qualified by the common deck name (refer to the description 


of the QUAL pseudoinstruction in the COMPASS Version 3 Reference Manual), so that no 
internal tags other than routine names should cause a tag conflict. If one of your routine 
names conflicts with a routine name in a common deck being used, you should rename your 
routine. : 

If you do not wish to rename your routines, you may instead use the following procedure. 


1. Define the tag QUAL$ to turn off automatic qualification of common decks. 


2. Manually qualify the entire common deck (including the routine names) with the QUAL 
pseudoinstructon. 


For example,-to use the space~fill-name common der COMCSFN, you can use the method shown in 
the for terrae sample program. 
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DUPLICT 


DUPLICT 


+ + * & F + HF F 


SFN 


IDENT DUPLICT 
ENTRY DUPLICT 


COMCMAC 
EQU 1 


THE *SPACE FILL 
BECAUSE THE PRO 
PROGRAMMER DOES 


SB1 1 

SA1 DUPA 
MxO -18 
SXx5 X1+ 
BXx1 xXO*X1 
RJ /SFILL/ 
SA6 DUPC 
$Xx1 X5+ 
RJ COD 
SB2 3 

RJ SFN 
SA6 DUPD 


MESSAGE DUPB,,R 
ENDRUN 


CON OLNAME+ 
CON 10H S$ 
CON 0 

CON JOHHAS 
CON 0 

CON 0. 
SPACE 4,10 


SFN ~- SHIFT REG 


ENTRY (X6) = 
(B2) = 

EXIT (X6) = 

USES B- 2. 
X - 6, 

SUBR 

SX7 B2 

$B2 B2+B2 

LX7 2 

sB2 B2+X7 

LX6 X6,B2 

EQ SFNX 

SPACE 4,10 


COMMON DECKS. 


COMCSYS 

COMCCDD 

QUAL SFILL 
COMCSFN 
QUAL 

SPACE 4,10 
END DUPLICT 


SUPPRESS AUTOMATIC COMMON DECK QUALIFICATION 


NAME* COMMON DECK MUST BE QUALIFIED 
GRAM HAS A SUBROUTINE *SFN* AND THE 
NOT WISH TO RENAME THE SUBROUTINE. 


ENTRY 

SET SYMBOL NAME IN MESSAGE 
CLEAR VALUE PORTION OF WORD 
SAVE VALUE 


Transfers control to 
COMCSFN, qualified 
by SFILL 


SFN SPACE FILL WORD 
CONVERT VALUE 


SHIFT VALUE 3 CHARACTERS LEFT 


Transfers control to 
the program’s shift 
register routine, SFN 


ISSUE MESSAGE 


123456 
YMBOL 
SYMBOL NAME 
VALUE 
CONVERTED SYMBOL VALUE 
MESSAGE TERMINATOR 
ISTER BY *N* CHARACTERS. 


REGISTER TO SHIFT. 
NUMBER OF CHARACTERS TO SHIFT. 


SHIFTED LEFT. 
7. 


ENTRY/EXIT 
SET NUMBER OF BITS TO SHIFT 


SHIFT REGISTER 
RETURN 


QUALIFY *SFN* 


RESTORE NULL QUALIFIER 
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The QUAL$ tag can also be used to suppress the qualification of common decks called more 
than once in separate overlays. In the following example, the QUAL pseudoinstruction is 
used in each of the two primary overlays; the symbol QUALS$ is used to allow a copy of 
COMCCDD in each overlay without symbol conflicts. 


OVER 
IDENT MAIN,MAIN,MAIN _ MAIN (0,0) OVERLAY 
ABS 
TITLE MAIN (0,0) OVERLAY. 
ORG 110B 
QUALS EQU 1 SUPPRESS COMMON DECK QUALIFICATION : 
a _ LOAD -TWO OVERLAYS - ONE AT A TIME - EACH WILL USE 
* ITS OWN COPY OF *CDD*, BUT WILL USE *SYS=* AND 
* *MSG=* THAT RESIDE IN THE (0,0) OVERLAY. 
MAIN $81 1 . 
- MESSAGE MAIA,,R * MAIN RUNNING.* | 
OVERLAY MAIB,0100B LOAD *OVL1* OVERLAY | 
SB2 x4 EXECUTE *OVL1« 
JP B2 . 
MAI1 . OVERLAY MAIB,0200B LOAD *0VL2* OVERLAY | 
SB2 x1 EXECUTE *OVL2* 
JP B2 
MAI2 MESSAGE MAIC,,R * MAIN COMPLETE.* 
ENDRUN END 
MAIA ——SO”dDATA~—sC®:- MAIN: RUNNING. * 
MAIB CON OLLGO OVERLAY FILE NAME 
MAIC DATA C® MAIN COMPLETE.* 
*CALL ‘COMCSYS 
*CALL COMCOVL 
OVER BSS 0 OVERLAY AREA BASE 
TTL PRIMARY (1,0) OVERLAY. 
EJECT 
QUAL _—OVL1 DEFINE QUALIFICATION FOR THIS OVERLAY 
IDENT OVL1,0V1,0V1,1,0 PRIMARY (1,0) OVERLAY - 
ORG OVER START AT OVERLAY AREA 
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ov 


OV1A 
OV1B 
ovic 


*CALL 


ove 


OV2A 
OV2B 
ovec 


*CALL 


READ THE REAL TIME CLOCK AND ISSUE A DAYFILE MESSAGE 
INDICATING WHEN OVERLAY WAS CALLED. 


RTIME 
SA1 

MxO 

BX! 

RJ 

SA6 
MESSAGE 


COMCCDD 


TTL 
EJECT 
QUAL 
IDENT 
ORG 


OVIA GET CURRENT TIME 

OVIA CONVERT MILLISECONDS TO DISPLAY CODE 
-36 

~X0*X1 

CDD 

ovic 

0V1B,,R * OVL1 CALLED AT NNNNNN* 
MAI1 RETURN 

0 REAL TIME CLOCK 

20H OVL1 CALLED AT : 

0 CONVERTED MILLISECONDS 

0 MESSAGE TERMINATOR 


PRIMARY (2,0) OVERLAY. 


OVL2 DEFINE QUALIFICATION FOR THIS OVERLAY 


OVL2,0V2,0V2,2,0 PRIMARY (2,0) OVERLAY 
OVER START AT OVERLAY AREA 


READ THE REAL TIME CLOCK AND ISSUE A DAYFILE MESSAGE 
INDICATING WHEN OVERLAY WAS CALLED. 


RTIME 
SA1 

MxO 

BX1 

RJ 

SA6 
MESSAGE 
EQ 


CON 
DATA 
CON 

CON 
COMCCDD 


END 


OV2A GET CURRENT TIME ; 

OV2A CONVERT MILLISECONDS TO DISPLAY CODE 
36 

-X0*X1 

cDD 

ovec . 

0V2B,,R * OVL2 CALLED AT NNNNNN* 

MAI2 RETURN 


0 REAL TIME CLOCK 

20H OVL2 CALLED AT 

0 CONVERTED MILLISECONDS 
0 MESSAGE TERMINATOR 


FILE ENVIRONMENT TABLE (FET) : 2. 
a ee ee a ae 


This section describes the file communication area necessary for file creation and the 
processing of many user requests. The file environment table (FET) is the standard 
communication area or parameter block for the system file processors. The COMPASS 
programmer must define the FET, whereas the higher level languages (COBOL and FORTRAN, for 
example) automatically establish and use this area. 


Depending on the. processor being used, certain areas of the FET must be defined and used in 


communicating with that processor. The minimum length of a FET is five words, although many 
processors require a longer FET. 


CIRCULAR BUFFERS 


A circular buffer: is a central memory storage area.that contains data during input/output 


‘operations. It.is called a circular buffer because routines that process input/output treat 


the first word of the buffer area as if it. were contiguous to the last word of the buffer 
area. ; 


All input/output is performed by passing data between a circular buffer in central. memory 
and a peripheral device (mass storage or magnetic tape, for example). 


The buffer pointers FIRST, IN, OUT, and LIMIT define the circular buffer (figure 2-1). 


circular buffer 


V7 


space for data 


Figure 2-1. Circular Buffer 
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FIRST ADDRESS 


FIRST is the address of the first word of the buffer area. Routines that perform 
input/output never change the value of FIRST. 


LIMIT ADDRESS 


LIMIT is the address of the word following the last word of the buffer area. Buffer data is 
not stored in LIMIT. When LIMIT is reached during a read or write operation, the next word 


to be read or written is FIRST. Routines that perform input/output never change the value 
of LIMIT. 


The addresses FIRST and LIMIT define the boundaries of the circular buffer. The size of the 
buffer is always (LIMIT-FIRST). 


IN ADDRESS 


IN is the address of the next word of the buffer into which data can be entered. During a 
read operation, the system enters data into the buffer beginning at IN; during a write 
operation, the user program enters data into the buffer beginning at IN. During a read 
operation, the system increments IN as it enters data into the buffer; when IN reaches 
LIMIT, the system immediately resets IN to FIRST. During a write operation, the user 
program must increment IN as it enters data into the buffer, and must reset IN to FIRST when 
IN reaches LIMIT (the data transfer macros described in section 3 increment and reset the 
buffer pointers as necessary for the user program). 


If, during a CIO operation, IN reaches (OUT-1), or IN reaches (LIMIT-1) and (OUT=FIRST), the 
buffer is full. The buffer is full when all words except one contain data. Because the 
system enters data into the buffer one PRU at a time rather than one word at a time for some 
CIO operations, the system may consider the buffer to be full if it attempts to enter data 
into the buffer and the buffer contains less than one PRU of available space. 


OUT ADDRESS 


OUT is the address of the next word of the buffer from which data can be read. During a 
write operation, the system removes data from the buffer beginning at OUT; during a read 
operation, the user program removes data from the buffer beginning at OUT. During a write 
operation, the system increments OUT as it removes data from the buffer; when OUT reaches 
LIMIT, the system immediately resets IN to FIRST. During a read operation, the user program 
must increment OUT as it removes data from the buffer, and must reset OUT to FIRST when OUT 
reaches LIMIT (the data transfer macros described in section 3 increment and reset the 
buffer pointers as necessary for the user program). 


If OUT reaches IN during. a CIO operation, the buffer is empty. Because the system removes 
data from the buffer one PRU at a time rather than one word at a time for some CIO 
operations, the system may consider the buffer to be empty if it attempts to remove a PRU of 
.data from the buffer and the buffer contains less than one PRU of data. 
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all words but one of the buffer contain data. 


Figure 2-2 is an example of a read operation. 


Before read operation ; After read operation 


circular buffer i circular buffer 


space for data 
(buffer empty) 


space for data 


Figure 2-2. Read Operation 


DATA SPACE 


At any instant a circular buffer is either empty, partially full, ot full. When empty, the 
available unused space in a buffer is one word less than the size of the buffer. When full, 


The system does not permit a circular buffer to be completely filled with data because the 
IN and OUT pointers would contain equal values and a full buffer could not be distinguished 
from an empty buffer. 


If IN is less than OUT, the amount of data in the buffer is (LIMIT-FIRST) - (OUT-IN) and the 
available space is (OUT-IN-1). If IN-is greater than OUT, the amount of data in the buffer - 
is (IN-OUT) and the available space is, (LIMIT-FIRST) - (IN+1-OUT). 
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Figure 2-3 is an example of a write operation. 


Before write operation After write operation 
circular buffer circular buffer 


(buffer empty) 


space for data space for data 


Figure 2-3, Write Operation f 


FET DESCRIPTION 
There are two basic FET formats. Figure 2-4 illustrates the standard FET for mass storage 
and terminal files; figure 2-5 illustrates the standard FET for magnetic tape files. The 


figures are followed by a description of the FET fields. When a field is used by only one 
of the file processors, it is noted in the description. 


local file name (Ifn) | code 


Pt AZ. sa as 
fe Se 
eee 


FNT pointer Tree. PRU size 


ae eee 
ME MAE 


current random index (cri) random request (rr) 


| Figure 2-4. Standard FET for Mass Storage and Terminal Files 


fRefer to section 5 for a description of the FET fields used in processing permanent file 
manager (PFM) requests. 
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local file name (Ifn) 


[erie ne tr wf | we | 
Pt VALZZZZZZA en | tit 
ee ee 


be ee 
Fran sone [ree [Pm wee [un 
® | 0 LLY 
sn Pte enter rt 0 enroctr) 
[oe [eerie [eration aote 


Figure 2-5. Standard FET for Labeled Magnetic Tape Files (C10 and POSMF)f | 
Parameter : ‘ ¢(FET+n) Position : - Description 
Local file name (1fn)_ mete 59-18 The 1fn field contains one to seven 


alphanumeric display code characters, 
left-justified; unused characters are 
zero-filled. The lfn is the common. 
reference point for all system 
communication concerning the file. 


j Level number (1n) 0 17=14 This is the level number for an end-of- 
; record (EOR)/end-of-file (EOF) 

operation on the file. NOS uses this 
-field for CIO operations and for 
distinguishing interactive input from 
noninteractive input (refer to CIO in 
section 3 and the discussion on writing 
interactive programs, section 12). 


Abnormal termination 0) 3 13-9 Status information returned by the 
codes (at) . function processor when an abnormal 
. ; situation or error occurs. This field 
' is usually set by the processor when 

the error processing bit: (ep) is set in 
FET+1. For some processors, at is 
returned in bits 17 through 9. This 
field is set to 22g by CIO if the ep 
bit is not set and an error condition 
is present. Refer to section 3 for 
the specific error codes returned. 


tRefer to the LABEL and OPEN macros for a description of the FET fields used in processing 
ANSI labels. 


eo @ 
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Parameter 


Code 


Device type (dt) 


Random access (r) 


User processing (up) 


2-6 


Word 


(FET+tn) 


0 


Position 


8-0 


59-48 


47 


45 


Description 


Request/return code. The user program 
(or macro) sets this code for the 
request desired. The function 
processors alter it only if the request 
is not completed. For example, the 
user program requests a read (CIO code 
010) but encounters an EOR. CIO 
returns a status code of 021. These 
codes are detailed in the function 
processor descriptions (refer to 
section 3). The following are 
subfields for the code parameter. 


Bit 1: file mode (fm). File mode for 
input/output operations on S, L, or SI 
tape formats only. For S or L format 
tapes, bit 1 is: 


0 Coded 
1 Binary 


Binary mode must be selected for SI 
tape formats or the program is aborted. 


Bit 0: interlock (ilk). FET interlock 
bit. Used to indicate system/user 
access to data associated with the 
file. The user program sets this bit 
to 0 (busy or not complete) and the 
processor sets it to 1 when the request 
is completed. 


The 12-bit display code of the type of 
device on which the file is or will be 
residing (refer to Device Types in 
appendix E). After the file is 
assigned to a device, the STATUS macro 
or any CIO function enters the device 
type in this field and sets bit 59 if 
the device is a nonallocatable nonmass 
storage device. 


This bit is set if random processing is 
to be performed on the file. If this 
bit is set, the FET must be at least 
seven words in length. 


The user program sets this bit to 
control end-of-reel or end-of-device 
processing. When CIO encounters an 
end-of-reei/end-of-device, it returns 
an abnormal termination code of 2 (bits 
13 through 9 of FET+O). For further 
information about end-of-reel 
processing, refer to the CIO CLOSER 
macro description. 
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Parameter 


Error processing (ep) 
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Word 
( FET+n) 


1 


Position 


44 


Description 


This bit is used to indicate to the 
function processor that the calling 
program processes errors that occur, 
such as parity errors or errors in 
requests to the file managers. The 
function processor returns the error 
code to the at field of FET+0O. Refer 
to the section of this manual relating 
to the specific processor called for 
descriptions of the error codes 
returned. If this bit is not set, the 
function processor either aborts the 
job or requests operator intervention. 


If an unrecovered parity or block too 


- large error occurs during a magnetic 


tape read operation (with the ep bit 
set) or if a read parity error occurs 
on a mass. storage read operation (with 
ep bit set), the system performs the 
following steps. 


1. The data in the bad block is 
stored in the user program’s 
circular buffer. 


2. The value of the IN pointer 
prior to the read is stored in 
the next word in the circular 
buffer (pointer to the 
beginning of the bad data 
block). 


3. The parity error code is set in 
FET+0. 


4. The IN pointer is updated in 
the FET. This IN pointer value 
does not include the additional 

_ word (pointer to the beginning 
of the bad data block) stored 
in the buffer. 


5. The FET completion bit is set. 


The pointer to the bad data is returned 
on all reads processed by CIO for a 
mass storage file. If no data is 
transferred (correct PRU not read), the 
pointer points to itself, and.no update 
of IN occurs. 


If tape error processing is inhibited 
(refer to the LABEL macro, section 4), 
the preceding steps are not performed 
regardless of whether or not the ep bit 
is set. 
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Parameter 


| Real time bit (rt) 


Extended label 
processing (x1) 


Access level 
bit (a) 


Flush bit (fb) 


Word 
(FET+n) Position 
1 43 
1 41 
1 39 
1 36 


Description 


When the real time bit is set, the job 
will not roll out and will not wait for 
an inaccessible device. The real time 
bit may be set directly in the FET by a 
CPU program or it may be set using one 
of the FET creation macros: FILEB, 
FILEC, RFILEB, or RFILEC. 


Specifies standard (xl=0) or 
extended (xl=1l) tape label processing. 


If this bit is set, the file”s security 
access level is to be taken from or 
returned to the al field in FET+4. 


If this bit is set, the file’s circular 
buffer is to be flushed upon abnormal 
termination or for terminal files when 
the job is rolled out. 


Files that are pointed to by the list 
of files (refer to the SETLOF macro, 
section 6) and meet the following 
criteria are flushed with the 
appropriate write function. 


e Original error flag (ef) is 
less than SPET (refer to EREXIT 
macro, section 6). 

e No buffer parameter errors; 
that is, the entire FET must be 
within the job’s field length 
as follows: 

LIMIT.LE.FL 

OUT.LT.LIMIT 

OUT.GE.FIRST 

IN.LT.LIMIT 

IN.GE.FIRST 

-@ The code field of the FET is 

set to one of the valid 
function codes that enable 
implicit terminal output (refer 


to table 3-1). 


e No CIO error code is present in 
the FET. 


e Data is in buffer. 
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Word 


Parameter (FET+n) Position 
FET Penech (len) —_ | ir es 18 
first . 1 _ 17-0 
in . 2 | 17-0 
out he . - 3 17-0 
FNT pointer 7 59-48 
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’ Description 


At the end of the job step, files are 
flushed with an end-of-record write 
(C1O function 024) unless the last 


‘function in the FET is a WRITECW (204) 


or WRITEN (264), in which case that 


‘function is reissued. The FET status 


is not changed for implicit terminal 
output, but the action taken by the 
system is the same as if a buffered 
write (CIO function 14 or 16) had been 
issued. 


Care must be taken when select- 
ing random files to be flushed 
since they could be truncated 
by an end-of-record write. 


Specifies the additional length of the 
FET beyond normal size (five words). 
For example, if len = 3, FET length =. 
10g and FET+7 is the last usable 

word. Function processors require 
varying lengths for particular 
parameters. 


First word address of input/output 
buffer (FIRST address). 


The next. available location for 
entering data into the buffer (IN 
address). The upper 42 bits should 
never be used since the function 
processors read and write the entire 
word. 


The next available location for 
removing data from the buffer (OUT. 
address). The upper 42 bits should 
never be used since the function 
processors read and write the entire 
word. 


. Relative address of the local file name 


table (FNT) entry for the file. The 
system uses this pointer to reduce 
overhead when processing a file. 


Parameter 


al 


PRU size 


limit 


fwa working storage 


lwatl working storage 


la 


Current random index 
(cri) : 
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Word 


(FET+n) 


4 


Position 


38-36 


35-18 


17-0 


47-30 


17-0 


17-0 


Description 


The numerical value of the file’s 
security access level. (You can use 
the system OPL common deck COMCVLC to 
convert access level names to the 
corresponding numerical values, and 
vice versa.) 


Number of central memory (CM) words in 
a physical record unit (PRU) for the - 
device to which the file is assigned. 
The PRU size for mass storage is always 
100g CM words. The PRU size for 
magnetic tape varies according to the 
data format selected. Refer to 
appendix J for information on magnetic 
tape PRU size. 


This field is set only if the file is 
opened using the CIO OPEN macro. 


Last word address plus 1 of the buffer 
(LIMIT address). Data is never placed 
in or removed from LIMIT. 


First word address of working storage. 
Working storage is used by several of 
the compilers to control input/output 
in specific formats (blocking/unblock- 
ing). This parameter is not used by 
the system or the NOS common decks that 
refer to working storage areas. 

Working storage areas for use by macros 
(READS, READC, and so forth) require 
the user program to define its own 
working storage area and specify this 
area on each macro request. Pointers 
to working storage can be placed here 
for reference. 


Last word address plus 1 (LWA+t1) 
of working storage. 


List address (CIO READLS and RPHRLS 
macros only). This points to the table 
of relative sector addresses. 


The current random index for the mass. 
storage file being randomly accessed. 
The system returns the current position 
of the file after a random input/output 
request. This index is in the form of 
a relative sector address (rsa) from 
the beginning of the file. For any 
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Parameter 


Random rewrite’ 
request (w) 


Unused bit count (ubc) 


Random request (rr) 


Maximum logical record 
size (mlrs) 


Index length (il) 


Index first word 
address (if) 
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Word 
(FET+n) Position 
6 29 
6 29-24 
6 : 28-0 
6 17-0 
7 35-18 


Description 


nonrandom read or write operation, the 
system updates this field by adding the 
number of sectors transferred to the 


' existing contents of the field. For 


any random access or positioning 
operation, the value is recalculated. 
cri is ignored if r (FET+1) is not set. 


This bit is set to indicate a rewrite- 
in-place operation for one of’ the 
following functions: WPHR, WRITE, 
WRITER, WRITECW. If rr#0 and this bit 
is not set, the write takes place at 
EOI with rr being used for the address 
for the return of rsa, where the write 
began. If w=0 and rr=0, a sequential 
write is performed at the current 
position of the file. This bit is 
ignored if r (FET+1) is not set. — 


Specifies the unused bit count for §$ 
and L format tapes (refer to 
appendix J). 


Relative sector address (rsa) for a 
random input/output request. An 
exception is that if w=0 and the 
request is a write request, then rr is 
the address for the return of the 
starting rsa of the write (previous 
EOI). “3 


If the error processing bit (FET+1, bit 
44) is set and an error occurs on a CIO 
request, the system returns detailed 
error status information to bits 11 ; 
through 0. For. further information, 
refer to the description of CIO in 
section 3. rr is ignored if r (FET+1) 
is not set. ; 


Specifies the maximum physical record 
size for S and L format tapes. Refer 
to appendix J. : 


Random index length. This must be set 
by the user program when requesting CIO 
OPEN to load the random index of a file 
or CIO CLOSE to dump the random index 
of a file. If r (FET+1) is not set, il 
is ignored. ; 


First word address of the index buffer. 

This is the area where CIO OPEN stores 

the index when opening a file or the 

area from which CIO CLOSE takes the 

index when closing a file. If 

r (FET+1) is not set, if is ignored. 
; a 2-11 


Parameter 


File identifier 


File identifier 


File sequence number 


Generation version 
number (gvn) 


Retention cycle 


Creation date 


Set identification 


‘File section number 


Word 
(FET+n) 


llg 


128 


12g 


13g 


13g 


13g 


148 


14g 


Position 


59-0 


59-18 


17-0 


59-48 


47-30 


29-0 


59-24 


23-0 


Description 


File identifier (first 10 display code 
characters, left-justified with display 
code blank fill).f 


File identifier (last seven display 
code characters, left-justified with 
display code blank fill). f 


One- to three-digit numeric display 
code file sequence number 
(right-justified with display code zero 
fill).t 


One- or two-digit numeric display code 
generation version number 
(right-justified with display code zero 
fill).t 


One- to three-digit numeric display 
code retention cycle (right-—justified 
with display code zero fill).f 


Creation date (two-digit numeric 
display code value for the year 
followed by a three-digit numeric 
display code value for the day within 
the year).f 


One- to six-character set 
identification (left-justified with 
display code blank fill).? 


One~ to four-digit numeric display code 
file section number (right~justified 
with display code zero fill).f 


The r, w, and rr FET parameters affect file manipulation operations as shown in table 2-l. 
The effects of. these parameters depend on the type of operation (read, write, or rewrite) 


being performed. 


‘TRefer to the HDR1 label in Volume 3, System Commands. 
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Operation 
Read, 


write, and 
rewrite 


i i | Rewrite 
@ | i 


Write 


Rewrite 


Read 


& Ae _ Write 


Rewrite 


Table 2-1. Effects of r, w, and rr FET Parameters on File Manipulation Operations 


Definition 


Operation is sequential. 


4 


-|-Reads from current position (same as se quen- 


tial except cri is returned). 
Sequential write is performed. 


Random write at current POstEAOn is per~ 
formed. 


Random read from rr is performed. 

Write is performed at current EOI (position 
of file before write returned at address 
specified by rr). 


Random write or rr is performed. 


Reads from current position (same as 

sequential except cri is returned). 
' : 

Sequential write is performed. 


Random write at current position is per- 
formed.. 


Random read from rr is performed. ' 
Random write at rr is performed. 


Random write at rr is performed. 


A random operation can be performed. The system returns the ‘current 
random index Cert) bi FET+6 (position of file. when the operation is. 


complete). 


' Sequential write Writes at current position; data is ‘followed by an EOI. 


Random write Writes data without an EOI at the end (the remainder of the file, the 
portion following the data written, is not released). 


cri - Rmeans value is returned; 
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NR means value is not returned. 


FET CREATION MACROS | 


The following four macros initialize FETs. They can be used to create sequential 
files, sequential binary files, random coded files, and random binary files. 


FILEB 
The FILEB macro creates a FET for a binary sequential file. 


Macro format: 


Location Operation Variable 
lfn F ILEB fwa,length,p, 5P,,+++sP, 
FILEC 


The FILEC macro creates a FET for a coded sequential file. 


Macro format: 


Location Operation Variable 
1fn FILEC fwa ,length,p) 5Pos+++sP, 
RFILEB 


The RFILEB macro creates a FET for a binary random file. 
Macro format: 
Location Operation Variable 


lfn RF ILEB fwa,length,p) sPys+++sP, 


coded 
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RFILEC 


Macro format: 


Location 


lfn 


Operation Variable 
RFILEC fwa, length, Pp, ,P,,- 


‘The RFILEC macro creates an FET for a coded random file. 


+-/P 


n 


The following parameters apply to each FET creation, macro. 


lfin 
fwa 


length 


Length of the CIO buffer. 


multiple of PRU size. 


Device 


Mass storage 


Tape (I and SI 
formats) 


Tape (LI format) 


Terminal 


Local file name and address of FET. 


First word address of CIO buffer. 


Minimum (Octal) 


101 (without 
control words!) 


103 (with 
control words) 


1001 (without 
control words) 


1003 (with 
control words) 


10001 (without 
control words) 


10003 (with 
control words) 


Because the buffer is full when (IN=OUT-1) or 
(INsLIMIT-1) and (OQUT=FIRST), the buffer length should not be an exact 

The following are the minimum and recommended buffer 
sizes for mass storage, tape, and terminal input/output. . 


Recommended (Octal) 


1001 to 2001 (without control 
words) ; 


1021 to 2041 (with control words) 


3n+1 to 4n+1, where: 


n=1000 (without control words) 


n=1002 (with control words) 


3n+1 to 4n+1, where: 


n=10000 (without control words) 


n=10002 (with control words) 


101 for input 
recommended for 
terminals with 


(larger sizes are 


301 for output line speeds above 


1200 baud) 


Refer to appendix J for a description of PRU sizes for S, lL, and F tape 


formats. 


f Refer to the CIO READCW (200). request for a description of control words. 
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Pj The following parameters can be used to set fields in the FET. They can be 
specified in any order. 


Parameter Description 
DTY=dt Sets the device type to dt. The user program must 


specify display code equivalent of dt. For example, 
set device type to TT by specifying DTY=2RTT or 
DTY=2424B. Refer to appendix E for legal device 


types. 

EPR Sets the error processing bit (FET+1, bit 44). 

FET=len, sets the length of the FET to len. 

IND=addr, leno Sets the index first word address to addr and the & 
index length to leno. 

LBL Sets the FET length to 15g for tape label processing. 

RTP Sets the real time processing bit (FET+1, bit 43). 

UPR Sets the user processing bit (FET+1, bit 45). 

WSA=addr,len3 Sets the first word address of working storage to addr 


and the length of working storage to len3. 


XL Sets the extended label processing bit (FET+1, bit 41) @ 
and sets the FET length to 15g. 


The following parameters are used for setting PFM communication words and 
fields (refer to chapter 5) in the FET. 


IPR Sets the interlock processing bit (FET+1, bit 42). 

PFN=pfn Sets the permanent file name in FET+10g to pfn. 

PWD=pwd Sets the permanent file password in FET+12, to pwd. eS 
PKN=pn Sets the pack name for access to permanent files 


residing on auxiliary devices in FET+14, to pn. 


SAD Sets the suppress address on the error message bit 
(FET+1, bit 46). 


UCW=ucw - Sets the user control word (bit 59 must be set to 
indicate that the word contains user control 
information) in FET+13g, to ucw. 


USN=un Sets the alternate user name in FET+11g to un. 


The following example illustrates the use of FET creation macros to create an FET for 
sequential input/output operations. 


BUFL EQU 2001B 
TAPEL FILEB BUF,BUFL, (FET=7) 
BUF BSS BUFL 
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The following example creates a FET for retrieving a file from permanent file storage, 
loading the index block, and performing random input/output operations. 


BUFL 
INDXL 
TAPE1 
BUF 
INDX 


: 


Eau + 20018 

eau 1008 

RFILEB BUF ,BUFL,(FET=10D) , (PFN=STOCKS) , CIND=INDX, INDXL) 
BSS —_BUFL 

BSS INDXL 


FET MODIFICATION MACRO - 


The SETFET macro modifies specified fields in a FET during program execution. 


Macro format: f 


Location 


addr 


Pi 


r 


Operation Variable 


SETFET addr ,P]sP2.*se5Pn | 


Address of FET to be modified. 


Parameters specifying fields in the FET to be modified. 


The following parameters can be used to modify fields in the FET. They can be specified in 


any order. 


{This macro is 


. SETFET does not verify that the modified 
words are within the FET length. 


not available in SYSTEXT. The user program must specify systems text ~ 


PSSTEXT or call-common decks COMCCMD and COMCMAC (refer to appendts F). COMCMAC defines 
the X=pseudo macro which is used in COMCCMD. : : wo 
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Pi 
BUF=fwa ,leng th 


DTY=dt 


ERA=erad 


ERP=erp 


LFN=1 fn 


PFN=pfn 


PKN=pn 
PWD=pwd 


UCW=ucw 


-USN=un 


Description 


Changes the first word address of the CIO circular buffer to 
fwa and the length of the buffer to length. Thus, FIRST, IN, 
and OUT are changed to fwa and LIMIT is changed to fwatlength. 


Changes the device type to dt. The dt option is the display 
code equivalent of the device type, right-justified with 
binary zero fill in a register or a central‘ memory location 
as described in SETFET Parameter Processing. Refer to 
appendix E for legal device types. 


Changes the error message return address to erad for PFM 
requests (refer to Error Processing in section 5). 


Sets the error processing, user processing, or real-time 
processing bit, or combinations of the error and user 
processing or error and real-time processing bits. The erp 
option can be a mnemonic as follows. 


erp Value Description 

U 4 Set user processing bit at FET+1, 
bit 45. 

E 2 Set error processing bit at FET+l, 

R 1 Set real-time processing bit for PFM 


requests at FET+l1, bit 43 (refer to 
section 5). 


UE 6 Set both user processing bit and error 
processing bit. 
ER 3 Set both error processing bit and 


real-time processing bit. 
If an erp other than those listed is specified, it must be a 
register or central memory location containing the value of 
erp (refer ‘to SETFET Parameter Processing). 


Changes the local file name in FET+0 to ifn.f 


Changes the permanent file name in FET+10g to pfn for PFM 
requests. f 


Changes the pack name in FET+14g to pn for PFM requests.f 
Changes the password in FET+12g to pwd for PFM requests.f 
Changes the user control word in FET+13g to ucw for PFM 

requests (bit 59 of ucw must be set if this field is to be 


used on a CHANGE request).f 


Changes the alternate user name in FET+11g to un for PFM 
requests. f 


T This option is left-justified with binary zero fill in an X register or central memory 
location as described in SETFET Parameter Processing. 
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SETFET PARAMETER PROCESSING 


For the DTY, ERP (when mnemonics are not used), LFN, PFN, PKN, PWD, UCW, and USN parameters, 
the following rules apply. 


e If an option is represented by a register, the register contains the value to be 
placed in the FET. For example: 


SETFET F, (LFN=X4) 
uses the contents of X4 as the new local file name. 


e If an option is represented by a constant, the constant specifies the address 
containing the value to be placed in the FET. For example: 


SETFET F, (LFN=LOFN) 


uses the contents of location LOFN as the new local file name. The file name can be 
specified in a literal as follows: 


SETFET F, (LFN=6LOUTPUT) 


e If an option is a register that is preceded by the number sign (#), + the register 
specifies the address containing the value to be placed in the FET. For example: 


SETFET F, #B3 
uses B3 as. the address containing the value to be placed in the FET. 
e If an option is a register expression or constant preceded by the number sign, it 
specifies the address containing the address of the value to be placed in the FET. 
For example: 


SETFET F, (LFN=#FADDR) 


uses the contents of FADDR as the address containing the value to be placed ‘in the 
FET. 


For the BUF and ERA parameters, the following rules apply. 


e If an option is represented by a register, the RESASECE contains. the value to be 
- placed in the FET. For example: : 


SETFET F,(ERA=A5) 
uses the contents of A5 as the new error message return address. 


e If an option is represented by a constant, the.constant-.specifies the address value 
to be placed in the FET (not. the address-containing the value). For example: 


SETFET F, (ERA=ERRBUF ) 


uses the address ERRBUF as. the new error message return address. 


{The equivalence sign (=) in the CDC graphic character set (display code value 60g). 
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SETFET EXAMPLES . 


Example 1: 


The SETFET macro can be used to take advantage of the way in which FORTRAN passes 
parameters to subroutines. Assume a FORTRAN program calls a COMPASS subroutine GETF to 
retrieve a permanent file. The call accepts three parameters to select the local file 
name, permanent file name, and file password: 


CALL GETF(1fn,pfn, pwd) 


When FORTRAN processes the call, it builds a central memory table with one entry for 
each parameter, terminated by a zero word. The entry contains the actual address of the 
parameter. Before control is passed to the subroutine, FORTRAN sets the Al register to 
the first word address of the table. Thus, X! contains the address of the first 


parameter. If the call to GETF is: & 


CALL GETF(DATA1,BASE1, PWD1) 


the Al register is the first word address of the table of addresses, Xl contains the 
address of DATA1, location Al+l contains the address of the next parameter, and so on. 
The following SETFET macro call uses the contents of the table to build an FET. 


SETFET F, (LFN=#X1) , (PFN=#A141) , (PWD=#A1+2) 


| F FILEB BUF,301B(FET=16D) @ 


BUF BSS 301B 


Example 2: 


Similarly, a COMPASS program could place the values in the FET as follows: 


SA1 DATA1 
SB3. BASE : & 
SETFET F,(LFN=X1),(PFN=#83) , (PWD=PWD1) 

DATA1 DATA  OLDATA1 

BASE1 DATA OLBASE1 

PWD1 DATA OLPWD1 | 

FO FILEB BUF,301B, (FET=16D) 

BUF Bss 301B 
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INPUT/OUTPUT e a a ee, 
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This section describes the process of performing input/output (1/0) from a COMPASS program. 


This section is divided into two.parts, combined input/output (C10) and data transfer. The 
CIO part includes those macros needed for file creation, read and write functions, and file. 
positioning. The data transfer part includes those macros that allow the user program to 
transfer information between the circular buffer and a working buffer area. 


The user program can perform 1/0 directly through FETs using CIO or with CYBER Record 


' Manager facilities that are available to COMPASS users through COMPASS macro calls. A brief 
description of CYBER Record Manager features is provided later in this section. 


COMBINED INPUT/OUTPUT (CIO) 


The CIO read/write requests are used to transfer data between a file and a CIO circular 
buffer. The read requests transfer input files from a system storage medium to a C10 
circular buffer. The write requests transfer output from a CIO circular buffer to a system 
storage medium. Also included in this group of requests are those which open and close 
files, those which update records in an existing mass. storage file, and those which control 
positioning of the file. ’ 


The format of the call to CIO is: 
59 4035. 17 0.36 


r Auto recall option; if any value is specified for r, control is;,not 
returned to the user program until the operation is complete. 


n Count for skip operations. 
addr Address of the FET. 
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Word FET+0O contains the following information. 


59 7 3 8 (e} 


revsop tet fot cote 
lfn Local file name. 
in Level number (0<1n<17g) for an EOR/EOF operation on the file: 
Level Number Description 
0 EOR operation. 
1-16, Same as level 0. 
17g EOF operation. 
at Abnormal termination code returned by CIO: 
Code (Octal) Description 
Ol End of information encountered. 
02 Device full/end of reel encountered. 
04 Parity error. 
21 End of multifile set. 
22 Fatal error. 
23 Random index too large for index buffer on OPEN. 
code Request/return code: 
Bit(s) Description 
8-2 Individual return code from a CIO function. Refer to 


the specific function for the bit settings and their 
meanings. Table 3-1 contains a summary of these codes. 


1 File mode bit. Binary operation if set (applies only to 
SI, S, and L format tapes); coded operation if zero 
(applies only to S and L format tapes). 


Binary mode must be selected for SI format 
tapes or the job will abort. 


0 Completion bit; indicates operation complete if set. 
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The file mode (fm) bit, bit 1 of FET+0, is not actually part of the status response, 
although it is returned as such. The fm bit is used by tape drivers, in some cases, to 
determine parity (seven-track) or whether conversion is required between character sets 
(nine-track). For disk 1/0, the bit is carried for compatibility with tape I/O but is 
meaningless. The bit is set by the FILEB or FILEC macros or directly by the user et sa 
After this it is retained as part of the return code. 


The CPU program is expected to issue an even request code (bit 0=0). If it does not, a 
completed operation may not be detected. 


CIO uses FET+5 and FET+6 in the following manner. 


FET +8 MY 


VLLLLLILLLLALA ALLA AA ALLL ALLL LLL A be YZ. eae Hin agnetic ta pe t 
| L_LLLLLLLLLLL LLL LL pie rae 


mass storage 


+6 


‘la : Address of a list of random addresses to be used with READLS or RPHRLS 
mass storage operations. 


ubc Unused bit count for S and L format tapes. 

mlrs Maximum PRU size for S and L format tapes. 

“i Current random index (for mass storage files only). 

_Random rewrite request (for mass storage files only). i 


rr Random request (for mass storage files only): if rr#0, and the request 
is a read request, rr is the random index. ’ 


If rr#0, w=0, and the request is a write request, rr is the address for 
return of random index (the write operation begins at the current EOI). 
The index of the EOI prior to the write is returned to the calling 
program. 


“If rr#0, w=l, and the request is a write request, rr is .the rendow andex 
indicating where the write will begin. 


dec Detail error return code (for mass storage files only). 


Code ' Type of Error 


x001 Parity error. 
x002 Address error. 
«003 Device status error. 
ae : x004 6681 function reject or function set to mass storage 
device that timed out with no response. 
«005 Device reserved. 
x006 Device not ready. 
4007 Track limit (device full). 


¥these fields apply only to S and L format tapes. 
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If, after a read error (with ep bit set), the system determines that the 
correct PRU was read (although it may contain incorrect data) then x 
above is set to 0, the data is placed in the buffer, and the file is 
positioned to the next PRU of the file. If the correct PRU is not read, 
then x is set to 4, no data is placed in the buffer, and the file is not 
repositioned. The cri is set as usual. 


Equipment that may be accessed by CIO includes: 
e Mass storage. 
e Magnetic tape units. 


e Terminals. 


CIO FUNCTION PROCESSING 
All of the CIO macros require the following two common decks for system interface. 


e COMCCIO 
e COMCSYS 


These common decks are available to you in relocatable form on the user library SYSLIB. 


If a CIO macro specifies a FET that currently does not have the completion bit (bit 0 of 
FET+O) set, common deck COMCCIO will wait (by performing recalls) for completion before 
performing the specified function. 


Error processing for functions issued to CIO involves processing only those errors that 
occur on the specified devices which include read and write parity errors to magnetic tape. 
If a mass storage device returns an error status or the device driver detects an error, the 
system places the error status in the at (abnormal termination) field of FET+O. If the 
error processing bit is set in the FET+1 ep field and the FET length is greater than six, a 
detail error code is returned to the user program in the FET+6 dec field. 


Table 3-1 lists the status response codes returned for the CIO functions, and shows which 
functions have the following properties: 


e The system verifies the FIRST and LIMIT circular buffer parameters during the CIO 
operation. 


e The system verifies the IN and OUT circular buffer parameters during the CIO ‘ 
operation. . 


° The system sets the IN and OUT circular buffer parameters to FIRST during the CIO 
operation (emptying the circular buffer). 


e The function can only be performed on a file residing on a mass storage device. 
e The function can only be performed on a file residing on a magnetic tape device. 
e The function can be performed on a file residing on device type TT (assigned to an 


interactive terminal). 
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e The function can be performed on a file residing on device type NE. 


° The data in the circular buffer of the file whose FET has the specified function 
will be printed at the terminal upon job step abort or job rollout if the. file is 
included in a list of files in RAt2 or in a list specified in a SETLOF macro 
(refer to SETLOF macro description in section 6), and if the file is assigned to 
device type TT. 


e The function can be performed on an execute-only file. 


The status response codes shown in table 3-1 are returned the lower 18 bits of FET+0. Only 
those bits needed to distinguish the codes are shown: for-example, 021 indicates xxx021 in 
bits 17 through 0 of FET+0, where xxx can have any value..-The meanings of the status 


Meaning — 
EOR encountered 
EOF encountered 
EOL encountered 


Rewind 


‘response codes are as follows: - { 


Code(s)t > | | 


021 


740031,740271 


741031,741271 


051 


fThese codes-are returned for a coded: FET. The codes for a binary. FET end in 3 instead 
of 1 (refer to. the scar taco of the code field of FET+0 at the beginning of this 


section). 
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Table 3-1. CIO Function Status Response Codes and Processing Options 


Status 
Response 
CIO Function Function Code 


Can be 
Valid Issued 
for on 
Implicit Execute 
Terminal Only 
Output File 


i [ooo | oainvwoonreon[ x | x | | | ‘|_* |x | * | 


READ, READ-SKIP 010,020 021,740031,741031 


> 
WRITE, WRITE EOR, 
WRITE EOF 014,024,034 


en ae ee ee 


004 
040 
044 
050 
060 
070 
04 


100/300 


ere ae a 


1 : 
POSITION : 
MULTIFILE 110 


130/330 


OPEN READ REWIND 140/340 


OPEN WRITE REWIND 144 


CLOSE REWIND 150/350 
OPEN ALTER REWIND 160 
CLOSE UNLOAD 170/370 


WRITE CONTROL WORDS 2 
READ WITH LIST 2 


‘0 
1 


4 
ie) 740031 


REWRITE, REWRITER, 
REWRITEF 214/224/234 


READ PRU WITH LIST 740031 


SKIP RECORD FORWARD | 240 740271,741271, 
261 
OVERWRITE 244/254 


WRITE CONTROL WORDS 
S/L TAPE 


READ TO EOL 741031 


SKIP RECORD BACKWARD] 640 740051 ,74064) 


tThese codes are returned for a coded FET; the codes for a binary FET end in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section). The status codes for normal completion of a request are not shown. The status code for normal completion is identical to 
the function code, except that bit 0 of the field is set to indicate completion; for example, 261 is the status code for normal completion of function 


code 260. 
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ACCESSING FILES 


The two methods used to access files assigned to a job are sequential and random access. 
Any file can be accessed sequentially; however, only mass storage files can be accessed 
randomly. When reading a file sequentially, the user program (or the system) reads -all the 
information in the file from the current position to the end of the desired portion of the 
file. 


When reading a file randomly, the user program (or the system) reads only the desired 

portion of the file. Any mass storage file can be read randomly if the relative position, 
from beginning-of-information (BOI), of the. PRU to be read is known. The desired PRU can be 
read by placing the PRU number in the FET and making the proper I/O requests. The random 
address of a PRU is the number of PRUs that precede the PRU on the file. The first PRU that 
can be read or written is PRU 1. PRU O on ail mass storage files is reserved for system use. 


Several methods of random processing exist. The specific method depends on the language 
being used; however, the following rules apply in all cases. 


e Most random I/O operations require a directory or index that contains the random 
disk addresses of records in the file. 


r) An EOR or EOF 1/0 operation transfers one PRU for the EOR or EOF. 

e Random write operations must start within the current boundaries of the file. For 
example, it is not possible to randomly write PRU 20 of a file with a length of 
10 PRUs. It is possible, however, to write .10 PRUs starting at PRU 10 and extend a 
file with a length of 10 PRUs to a length of 20 PRUs. 


e When randomly rewriting data within a file, the user program must take steps to 
ensure. that data following the area to be written is not destroyed. 
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Figure 3-1 illustrates a typical example of the structure of a random access file, Record 3 
has random address 5. The first random address that can be read or written is address l. 


The first PRU (for mass storage, a PRU is equivalent to a sector) on ali mass storage files 
is reserved for system use. 


0] 7000 OOI6 O 


identifier 


: PRU 
word count =100g L 


word count = 36g 


record 1 


record 2 


” 
| word count=0 & 


word count *100g 


record 3 


record 4 


ee a 


record length random address @ 
_ The directory can be built in any 


format. This is a typical example. 


| | | 
| 


Figure 3-1. Sample Random Access File Format 
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READING FILES 


To read record 3 sequentially, the user program rewinds the file to BOI, reads the file, and 
counts the number of EORs. CIO file positioning macros can be used to skip records 1 and 2; 
however, the primary consideration is that the data must be read to determine where record 3 
begins. Once this is determined, record 3 can be read. 


If a directory exists for this file, the only requirement is that the random address of 
record 3 be obtained from the directory and placed in the FET. The proper random read 
requests can then be issued.. To perform this random read on record 3, the following steps 
are required. , 


e Skip to the EOI. This is done by the system without reading the entire file. 


° Backspace two logical. records (one record for the EOF and one for the directory). 
' The system must read both records to perform this operation. 


e Read the directory to obtain the random address to be placed in the FET. 


.4n EOF may or may not be present at the end 
of the file. The language and methods used 
to build the directory determine whether an 
EOF is present. If an EOF is not present, 
the directory can be read in automatically 
by specifying an index buffer on an OPEN 
request. , 


In summary, to access record 3 sequentially, four additional PRUs must be read. To access 
the. record randomly, only three additional PRUs are read: two PRUs to position the file to 
the directory and one PRU to read the directory. : 


For additional random -accesses to. any record in the file, it is not necessary to access the 
directory again if it remains in central memory. 


Each directory entry contains the record name, the first PRU of the record (random address), 
and the record length. The directory can be placed anywhere in the file. The only 
requirement for accessing a file randomly is that you must know where to position the file 
in order to read the directory. However, the directory usually precedes the EOF/EOI. 


WRITING FILES 


After reading and modifying record 3 of the sample file, the user program may rewrite the 
record in the file. If the modifications have not changed the number of PRUs required, a 
write operation can be used to replace the existing record with the modified record. This 
write operation must be issued as a random I/O operation. However, if the modifications 
have changed the number of PRUs required, data following the record being written is lost. 
For example, the size of record 3 in. the sample file is 112g words or two PRUs. A maximum 
of 65g words can be added to the record without requiring an additional PRU and destroying 
data. If a random write request net adds 65g words to record 3 is issued, the file would © 
have the following format. 
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word count=0 4 


word count=100g 


5 

word count: 779. 6 

/ word count=100, 07 
11 


EOF 
record 3 


EOR 


; This operation is called a rewrite in place. If the write had béen issued as a nonrandom 
& write operation, the file would have had the following format. 


e 


EOF 


: word count=100g 5 
record 3 7 3 
: 
EOI 
& All data following the inserted data would have been destroyed. If the word count for 


record 3 had been increased to 212g, a random rewrite could not have been performe 


d 
without destroying PRU 7. The file would then have the following format. ; 


io. 2 
bee 


EOF 


record 3 


EOR 


To properly rewrite record 3 without destroying the contents of PRU'7, the user program. . 
could issue a write request at the end of the file and alter the directory to reflect the 
change. Figure 3-2 illustrates the updated file containing the new directory and the 
2129-word modified record 3 written at the end of the file. 


2 _ (60459690 A 


word count=100, 
record 1 

word count=36g EOR 
record 2 { word count=12g eon 


3 
= 4 
word count=O EOF 


0] 7000 0016 O————__—_—_ 
identifier 


tabl 
_ word count=100g Li able 


PRU 
BOI 0) 
= 1 
: 2 


record 4 word count=100g 0 
word count=12 n 


WERE 


word count =O 13 
word count=100, 14 
record 3 word count:100g !5 


word count=12g EOR 


EOR 
EOF 


word count=24 


record length random address 


The record 3 pointer in the 
directory has been updated 


Figure 3-2. Modified Sample Random Access File Format 


The shaded areas in the figure represent records that are still present in the file, but are 
not referenced in the new directory. These areas will not be accessed by programs that 
access this file randomly using the new directory. 


RANDOM REQUEST PROCESSING 


The user program can request that the system perform-the specified read or write request at 
the file position specified by the random request word (FET+6). If the file specified 
resides on mass storage and the random processing bit is set (r parameter in FET+1]1), then 
random access to the file can be performed. For a random write operation, the remainder of 
the file (the portion following the data written) is not released. On a sequential write 
operation, this portion of the file is released. 


The user program is responsible for managing the random addresses. For any CIO operation 


with r set in FET+1, the system returns. the current random index (cri) in FET+6. The cri is 
the position of the file when the operation is completed. 
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Nonrandom write operations after a random write operation are processed as random requests. 
Writing continues at the current position and the remainder of the file is not released. 


“This feature makes the recalculation of the random address unnecessary when randomly writing 


records LeTeee than the CIO circular buffer size. 


For a write operation with r set in FET+tl, if rr=0, a sequential write is performed at the 
current position. If rr#0, the action the system takes is as described for FET+6 fields 


. earlier in this section. 


For a REWRITE operation with r set in FET+l, if rr=0, a random write is performed at the 
current position. If rr#0, a random write is performed at rr. 


For the random file shown in figure 3-l, the following random requests (that is, r is set in 
FET+1) are necessary to perform the operations described. Figure 3-2 shows the modified 
random access file that results from performing these requests. 


é d eri 
Operation rr w Returned Description 

READ 12g 0 - 13g Read directory. 

WRITER 20008 0 178 Write new record 3 at EOI. 
System sets location 2000g 
to 14g to indicate where the 
write occurred. 

WRITER 7 «wd 12g Write new record 4 in place. 

or 

REWRITER 7 0 12g Word count = 212g. 

WRITEF 17 1 21g 

or 2 _ Rewrite directory. 
REWRITEF 17g "0 21g 


The user program must account for the extra sector written for EORs and EOFs when specifying 
rewrite-in-place operations. 


The system computes the number of sectors written as follows (all numbers are in octal): 


. Word PRUs Data Remaining 
Operation. Formula Count Example Written © in Buffer 
Buffer write n/100 243 243/100 2 43 
EOR write (n+100) 243 (243+100) 3 ; 0 
= 100 100 : 

300 (300+100) 4 0 
100 

EOF write . (n+200) 243 (2434200 ) 4 0 
100 100 

300 (300+200) 5 0 
100 


Appendix H contains examples of COMPASS programs that create, read, and write a random file. 
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CIO PROCESSING ON SECURED SYSTEMS 


CIO performs the following additional processing on secured systems. 


READING FILES 
A read function (or an OPEN function that reads an index) performed on a file that has an 


access level higher than your job’s current access level causes your job’s access level to 
be raised to the access level of the file. 


WRITING FILES 

A write function (or a CLOSE function that writes an index) performed on a mass storage file 
with an access level lower than your job’s current access level causes the file’s access 
level to be raised to the access level of the job. Such a request on a tape file or an 
attached direct access file constitutes a security conflict and is rejected (unless you have 


special authorizations) since the access levels of these files cannot be changed while the 
files are attached to a job. 


CREATING FILES 


If CIO creates a local file as the result of a WRITE or OPEN request, the file is normally 
created with the same access level as the job’s current access level. If the access level 
bit (bit 39) of FET+1 is set, however, the file is created with the access level specified 
in FET+4, provided that access level is valid for the job. Specifying an access level lower 


than the current access level of your job constitutes a security conflict, unless you have 
special permission. 


STATUS RETURNED BY ClO 


If the access level bit (bit 39) in FET+l is set, CIO returns the current access level of 
the file to the access level field in FET+4 after each CIO request. 


ClO OPEN AND CLOSE FUNCTIONS 


Two macros are available for opening files. 

@ ' OPEN is applicable to all files. 

e POSMF is applicable only to labeled multifile tapes. 
Two macros are available for closing files. 

e CLOSE is applicable to all files. 


e CLOSER is applicable only to tape files. 
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POSMF is described in the discussion of file positioning functions. OPEN, CLOSE, and CLOSER 
are described in the following paragraphs. ; 


In general, there is no need to’ explicitly open or close mass storage files. The 
capabilities provided by open and and close functions for mass.storage files can be obtained 
through the use of other system macros. For example, appendix H illustrates the random 
processing of a file without using CIO open and close functions. Also, the example in this 
section of data transfer macros shows how a sequential mass storage file can be read and 


. written without using open and close functions. 


’ 


OPEN 


OPEN creates a file or determines certain information about a file for a job. If the file 
does not exist before the request to OPEN, it is created. 


-On a secured system, performing an OPEN function on a file with an index has the same effect 


on the job access level as a READ; that is, if the access level of the file is higher than 
the current access level of the job, the job’s access level is raised to the access level of 
the file. oe ; 


Macro format: 


- Location . Operation Variable 
. OPEN -_ addr,type,r 
addr _ Address of the FET for the OPEN request. 
type _ Type of function to be performed: 
Type "Function (With Code in Octal) 

READNR Read, no rewind (100). 
READ Read and rewind (140). 
WRITENR — Write, no rewind (104). 
WRITE Write and rewind (144). 
NR No rewind (120). Ss 
ALTERNR - Alter, no rewind (120). : : 
ALTER Alter and rewind (160). 
REELNR : Read reel, no rewind (300). 
REEL Read reel and rewind (340). 


If the user program specifies a function type of REEL (or REELNR) and 
the file resides on mass storage, CIO assumes the type is READ (or 
READNR). If the type is not specified, ALTER is assumed. The functions 
listed do not change the system read/write lock on the file. 
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For mass storage files, all rewind functions are identical as are all 
no~rewind functions. That is, the only effect function type has on a 
mass storage file is to specify whether the file is to be rewound after 
it is opened (READ, WRITE, ALTER, or REEL), or whether it is to remain 
at its current position (READNR, WRITENR, NR, ALTERNR, or REELNR). 


For magnetic tape files, READ, REEL, and ALTER perform identical 


functions and can be used interchangeably, as can READNR, REELNR, and 
ALTERNR. 


x Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 


The information supplied by OPEN includes: 


The PRU size for the device to which the file is assigned (FET+4, bits 35 through 


18). The PRU size returned for a magnetic tape file depends on the tape data format 
(refer to appendix J). 


The type of device on which the file resides (FET+1, bits 59 through 48). Refer to 


appendix E for a list of supported device types. In addition, bit 59 is set if the 
device is a nonallocatable nonmass storage device. 


The operations performed by OPEN depend on the type of device being used. 


Mass Storage Operations 


For mass storage files, if random processing is specified and proper pointers are set in 
FET+7, the last record of the file is loaded into the buffer specified. The random index on 
a file that is to be opened is expected to be the last record before the EOI. No EOFs may 
intervene. No indication of the length of the index loaded is returned other than a zero 
word in the buffer (OPEN clears the buffer before loading the index). If the buffer is too 
small to accommodate the entire index, an abnormal termination code of 23g is entered in 
FET+O, and the job step aborts unless the ep bit was set in FET+l]. The random access bit 
(FET+1, bit 47) is cleared during an OPEN operation if: 


The last record before the EOI is empty. 


If the index length (FET+7, bits 18 through 35) is not zero and the index area FWA 
(FET+7, bits 0 through 17) is less than two or greater than the job field length, 
the job step aborts. 


The file does not reside on mass storage. 


For all OPEN functions on mass storage, the index for a file is loaded into the index area 
specified. 
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Example: 


The. following example opens a random access mass “storage file and reads the directory in 
preparation for.random processing. og 


BUFL © Eau =. 20018 

INDXL . QU 1008 

FILE1 - RFILEB BUF,BUFL, (FET=8) , (IND=INDX, INDXL) 
BUF BSS —- BUFL 

INDX - BSS INDXL 


OPEN FILE1,,R. 


. iy 


Unlabeled Tape Processing 


If a no rewind option is specified (code 100, 104, 120, or 300), the tape remains jat its 
current position. If a rewind option is specified (code 140, 144, 160, or 340), the tape is 
rewound to the load point of the current volume. 


_ Nonstandard Labeled Tape Processing 


Since the system cannot write nonstandard labels, the job step aborts if a WRITE (144) or 


- WRITENR (104) function is specified for a file residing on a tape with nonstandard labels. 


-If a no rewind option is specified (code 100, 120, or 300), the tape remains at its current © 


position. If a rewind option is selected (code 140, 160, or 340), the tape is’ rewound to 
the load point of the current volume. . 


Nonstandard labels are not read or returned to the CIO buffer. If the tape is at the load 


_point, a subsequent read operation skips to the first tape mark before the read occurs. 


Standard ANSI Labeled Tape Processing 


When an ANSI labeled tape file is opened, the action the system takes depends on the xl bit 


 (FET+1, bit 41). If xl is 0, standard label processing. is performed; extended label 


processing is performed if xl is 1. 
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For standard label processing, all optional labels are ignored. If the FET for the file is 
at least 15g words long, FET+11g through FET+14g (refer to FET Description in section 2) 
contain the HDR1 data. The actual format of the HDR! label is shown in appendix J. The 
HDR1 fields are described in detail in Volume 3, System Commands. All fields contain 
alphanumeric or numeric display code values. Alphanumeric fields are left-justified with 
blank fill. Numeric fields contain display code numeric digits and are right-justified with 
display code zero fill. 


The tape remains at its current position if a no rewind option is specified (code 100, 104, 
120, or 300). If a rewind option is selected (code 140, 144, 160, or 340), the tape is 
rewound to the load point of the current volume. 


The system reads and/or verifies the HDR1 label if the tape is at the load point and a READ, 
REEL, or ALTER option is selected (code 100, 120, 140, 160, 300, or 340), with the following 
restrictions or requirements. 


° If the FET length is less than 15g words, the system accepts a standard label 
without verification. 


e If the FET length is at least 15g words, the HDR1 data in FET+11g through FET+14g 
is compared with that in the HDR1 label. Binary zero fields are not compared, 
although the actual value read is returned to the field. If any nonzero field does 
not match, the job step aborts. 


- A nonzero retention cycle (FET+13g, bits 47 through 30) is used to calculate 
an expiration date that is compared with that HDR1 field on the tape. 


- The HDR1 label is transferred to the C10 buffer (as space permits), although 


IN and OUT pointers are not updated to reflect the label information in the 
buffer. 


e All optional labels are ignored. 


The system writes a new HDR1 label if the tape at load point is opened for the first time 
with a WRITE operation specified (codes 104 or 144), and the FET length is at least 15g 
words. Subsequent OPEN/WRITE operations (following an OPEN/READ or OPEN/WRITE) do not update 
the label information, even if the file is opened, closed, and then reopened. The following 
restrictions or requirements apply. 


o If the FET is less than 15g words in length, the previous HDR1 label information is 
not changed. 


e If the FET length is at least 15g words, the system uses the information in FET+llg 
through FET+14g for the HDR] label. If any of the FET HDRI fields are binary zero, 
the system uses the default value. The current date is used instead of the create 
date field in the FET. A nonzero retention cycle field is used to calculate the 
expiration date (default is current date). 


e If a nonnumeric value is encountered in a numeric field, the job step aborts. 


e Previous HDR1 label expiration date is enforced; if the label date has not expired, 
the job step aborts. : 
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Example: 


‘The following example opens a magnetic tape file for standard label processing and 
verifies. the HDR1 label against values preset by the user program (the FET parameters 


are described in section 2). The magnetic tape file must have previously been assigned 


via a LABEL command or macro. 


BUFL EqU 30018 
FET Bss_ 0 
TAPE] - FILEB BUF,BUFL,LBL 
ORG = FET+11B 
FET 11 VFD 60/1 0HACCOUNT FI 
FETI2 VFD ° 42/0HLE,18/0H001 
FET13 VFD 12 /0H01,18 /0HO03, 30 /0H79023 
FET14 VFD 36 /OHSETID1, 24 /OHO001 
. ORG * 
BUF BSS BUFL 


OPEN FET,REEL,R 


In the preceding example, FET+11g through FET+14g contain the HDR1 data. The tape is 
rewound to the load point of the current volume and the HDR1 data in the FET is compared 
with the HDR1 label on the tape. If any field does not match, the job step aborts; 
otherwise, the HDR1 label is transferred to the buffer BUF where the user can further 
process it (refer to appendix J for the format of the HDRI label). 
If the OPEN macro in the preceding example is changed to 

OPEN FET,WRITE,R 


and the file is being opened for the first time, then the system uses the data in FET+11g 
through FET+14g to write a new HDR1 label on the tape. 


Extended Label Processing 

For extended label processing, a user label buffer, rather than the FET, is used to hold 
labels for processing. Extended label processing requires an FET length of at least 12g 
words, and an extended label buffer. Extended label processing is.disabled if these 
Sedu tromeare are not met. ; 


The buffer location must be specified in FET+11g as- follows: 


17 ie} 


Within the buffer, each label must be preceded by a status word.. 


CMLL 
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Only bits 11 through 0 should be set by the user program to show the number of characters in 
the label. This value must be 80 (120g), or the job step aborts. 


Remaining fields may be used by the label processor. The last label should be followed by a 
status word containing zeros in bits 11 through 0. Each label in the buffer appears, in 
display code, with the same format it has on the tape. 


The tape remains at its current position if a no rewind operation is specified (code 100, 
104, 120, or 300). If a rewind operation is selected (code 140, 144, 160, or 340), the tape 
is rewound to the load point of the current volume. : . 


If the tape is at the load point and READ, REEL, or ALTER is selected (code 100, 120, 140, 
160, 300, or 340), the system reads all labels to the first tape mark and verifies the HDR1 
label, with the following exceptions. 


° If the label buffer does not contain an HDR] label, the system accepts the standard 
label without verification. 


° If the label buffer contains an HDR] label, any nonzero field in the label buffer. is 
compared with that HDR1 field on the tape. If any nonzero field does not match, the 
job step aborts. 


e All labels from VOL1 through the first tape mark are transferred to the label buffer 
as space permits. Verification of additional labels is your responsibility. 


The system writes a new HDR1 label if the tape at load point is opened for the first time 
with a WRITE operation specified (code 104 or 144). If the file has been opened prior to 


- the OPEN/WRITE, the label information is not updated even if the file is opened, closed, and 


reopened. Further requirements and restrictions are as follows: 
e VOLI labels in the label buffer are ignored. 


° If an HDR1 label is not present in the label buffer, the system uses default values 
to create the HDR] label for the tape. 


° If an HDR1 label is present in the label buffer, it is used to generate the HDR1 
label on the tape. If any field in the label buffer is binary zero, the default 
value for that field is used. The current date is used instead of the create date 
in the buffer. The expiration date field is used; if zero, it defaults to the 
current date. 


e If a numeric field in the HDR1 label contains a nonnumeric value, the job step 
aborts. 


° Previous HDR] label expiration date is enforced; if the label has not expired, the 
job step aborts. 


e All user labels to be written must be present in the label buffer. All user volume 
labels (UVLI1 through UVL9), additional file header labels (HDR2 through HDR9), and 
user header labels (UHL) in the label buffer are written to the tape. Nonapplicable 
labels are ignored. : 
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Example: 
The following example opens a magnetic tape file for extended label processing and: 


verifies'the HDR label on the tape against values preset by the user program in the 
label buffer (refer to appendix J for the format of the HDR1 label). 


BUFL EQU 30018 
FET Bss OO : 
TAPE1 FILEB BUF,BUFL,LBL,XL 
BUF BSS. BUFL 
LBUF VFD = 48/, 12/80 
VFD  § 24/4HHDR1,36/6HACCOUN 
VFD  60/10HT FILE 
& VFD 6/1H,36/6HSETID1,18/3HOOO 
VFD 6 /1H1,24/4H0001 ,24/4H0001 ,6/1HO 


VFD 6/1H1,36/6H 79023,18/3H 79 
VFD 18/3H023,6/1H ,36/0 


BSSZ 3 
FET11B VFD 24/,18/100,18/LBUF 
- SA1 FET11B SET UP FET+11B 
BX6 x1 


SA6 FET+11B 


OPEN FET,READ,R 


If the OPEN macro in the preceding example is changed to 


OPEN FET, WRITE,R 


; and the file is being opened for the first time, the system uses the data in the label 
buffer to generate the HDR1 label on the tape, provided all requirements and restrictions 
are met. . ; 
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CLOSE 


CLOSE terminates operations on a file. 


Macro format: 


Location Operation - Variable 
CLOSE addr,type,r 
addr Address of the FET for the CLOSE request. 
type Type of function to be performed: 

Type Function (with Code in Octal) 

NR ‘File is not rewound (130). 

REWIND File is rewound (150). 

UNLOAD Tape file is rewound, released, and unloaded; mass 
storage file is released (170); it does not affect the 
user program’s resource demand count (refer to UNLOAD 
macro). 

RETURN Tape file is rewound and released; mass storage file is 
released (174); the number of tapes or packs scheduled 
for the job may be decreased (refer to RETURN macro). 

If type is not specified, REWIND is assumed. 

r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


If the file resides on mass storage, the random processing bit is set, and the proper 
parameters are set in FET+7, CLOSE writes the data in the buffer specified in FET+7 at EOL 


‘of the file. This normally is the index for the file. A random index is written at the EOL 


only if the FET indicates that the file is random, the file’s EOI position has changed since 
the last OPEN request, the file is not locked, and an index area is specified in bits 17 


through 0 of FET+7. 


On a secured system, performing a CLOSE function on a file with an index has the same effect 
on the file’s access level as a WRITE; that is, if the access level of the file is lower 
than the current access level of the job, the file’s access level is raised to the access 


level of the job. 
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Example: 


i 


Random processing for the program shown in the first.example of the OPEN macro can be 
terminated as follows: . . 


BUFL 
INDXL 
-FILE1 
BUF 
INDX 


Eau 20018 


EqU 1008 

RFILEB BUF,BUFL, (FET=10B) , CIND=INDX, INDXL) 
BSS —-BUFL 

BSS INDXL 


OPEN FILE1,,R. 


CLOSE FILE1,,R 


In this example, the system writes the random index contained in the index buffer at the 
end of the file. 


When a magnetic tape file is closed, the action the system takes depends on the last I/0 . 
‘operation performed. — ae : 


CLOSE/UNLOAD and CLOSE/RETURN can no longer 
be used to queue files (these functions 
release the file from the job in the same 
manner as UNLOAD and RETURN, respect-— 
ively). Programs using these functions 
should be rewritten to use the ROUTE macro 
if file queueing is desired. 


The system responds to a CLOSE request on a magnetic tape file in the following manner. 


1. If the last operation was a write, the system performs one of the following 
functions. ; 


60459690 A 


If the tape is unlabeled and the data format is S, L, or F, the system 
writes four tape marks. 


If the tape is unlabeled and-the data format is I or SI, the system writes a 


tape mark, an EOF1 label, and three tape marks. 


If the tape is labeled and standard label processing is in effect (xl, bit 


41 of FET+1, not set), the system writes a.tape mark, an EOF] label, and. 
three tape marks. 
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e If the tape is labeled and extended label processing is in effect (xl, bit 
41 of FET+1, set), the system writes a tape mark, an EOF1 label, all user 
end-of-file labels (EOF2 through EOF9) and user trailer labels (UTL) present 
in the extended label buffer, and two tape marks. All nonapplicable labels, 
including EOF1 and EOV1 labels, in the extended label buffer are ignored. 
Refer to Extended Label Processing earlier in this section for a description 
of the label buffer. 


If the last operation was a read and the following are true, then all labels from 
this tape mark (beginning with EOF1) through the next tape mark are transferred to 
the extended label buffer, as space permits, beginning at the first word of the 
buffer. 


e The tape is labeled. 
e Extended label processing is in effect (xl, bit 41 of FET+1, is set). 
e A tape mark immediately follows. 

2. If the no rewind (NR) option was selected, the tape remains positioned at or is 
repositioned to the same point as before the CLOSE was issued (to prevent the user 
program from going past EOI). 

If the rewind (REWIND) option was selected, the system rewinds the tape to the 
beginning of data of the current file. This operation is performed automatically 


even if the current file begins on another reel. 


If the unload (UNLOAD) option was selected, the system rewinds and unloads the 
current tape reel, releasing job and file attachment. 


If PO=U processing option was specified at 
tape assignment time, the tape will not be 
physically unloaded from the tape drive. 


If the return (RETURN) option was selected, the system rewinds and unloads the 
current tape reel, releasing job and file attachment. The number of tapes scheduled 
for the job is decremented only if the total concurrent resource demand (tapes and 
packs) f has been satisfied. 


' fRefer to the RESOURC command in Volume 3, System Commands. - 
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CLOSER . 


The CLOSER macro closes a magnetic tape reel. 


Macro format: - 


Location Operation - Variable 
" CLOSER addr,type,r 
addr —~ Address of the FET. 
type ' Type of operation to be performed: ‘ 
Type _ Function (with Code in Octal) 
NR , ; : No rewind (330). 
UNLOAD . Unioad (370). 
RETURN Return (374). 
omitted = Rewind (350). 


te the edienes file resides on mass storage, function 350 sets the 
file to BOI and function 370 releases the file. 


r Auto recall option; if any value is specified for r, control is not 
: returned to the user program until the operation -is complete. 


When a read or write operation encounters end-of-reel, control is returned to the user 
program if the user processing (up) option is set in the FET. The tape is positioned so 
that if the user program attempts another I/O operation, the result is the same as for the 
previous read or write. 


The CLOSER macro enables the user program to initiate end-of-reel processing. The 
definition of end-of-reel varies according to the processing option the user selects (refer * 
to End-of-Tape/End-of-Reel Conditions, appendix J). The action the system takes in’ response 
to a CLOSER request depends on the following two factors: . : 


e The last I/O operation performed. 
e The user processing option (FET+1, bit 45). 
The system performs the following BSduenes of actions during end-of-reel processing: 


1. If the last operation was a write, the preter Personne one of the following 
operations. : 


e If the tape’ is labeled, unlabeled SI, or unlabeled. I format, the system 
‘writes a tape mark. followed by an EOV] label and three tape marks. If: the 
user program has specified the VSN of the next reel (refer to Volume 3, 
System Commands, for a description of the VSN command), an EOV2 label 
containing that value is also written following the EOV1. User trailer 
labels present in the label buffer are written if extended. label processing 
is in effect. Refer to Extended Label Processing earlier in this section 
for a description of the label buffer. . : 


e If the tape is unlabeled and the data format is S, L, or F (refer to 
appendix J), the system writes four tape marks. 
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If the last operation was a read, the system performs the following steps. 


ae If extended label processing is in effect, all labels following from EOV1 to the 
next tape mark are returned to the extended label buffer. 


b. If the tape has an EOV2 label (except for SI unlabeled tapes) and was written 
‘ under NOS, the system extracts the VSN and proceeds to step 2. 


c. If the user has specified the VSN of the next reel, the system proceeds to step 
2. 


d. If the VSN of the next reel has not been specified and the tape has no EOV2 
label, the system proceeds to step 2. 


2. If the user processing option was selected, the system returns control to the user 
with end-of-reel status set in the FET. The user processing option does not apply 
to the RETURN (374) function. 


If the user processing option was not selected, the system returns control to the 
user program by setting the completion bit in the FET. In addition, if the tape is 
labeled and the FET length is at least 15g words, the system increments the file 
section number (FET+14g, bits 23 through 0). 


3. The system rewinds or unloads the tape as specified by the type parameter. The 
current reel is always unloaded if the next reel is not known or mounted. 


4. The system takes the following action if the file is. continued on a subsequent reel. 


e If the VSN of the next reel is known and the reel is mounted, the 1/0 
operation continues. If the VSN is not known or the reel is not mounted, 
the system requests the operator to mount it (the tape must be mounted on 


the same drive). Any labeled tape is accepted if the next VSN is not 
specified. 


e If the operation is a RETURN (374), a subsequent reel is not requested. The 
file is returned after the EOV label sequence is written. 


ClO READ FUNCTIONS 


CIO processes the following read functions. 


On a secured system, performing a read 
function on a file that has a higher access 
level than your job’s current access level 
causes your job’s access level to be raised 
to the access level of the file. 
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RPHR (000) 


RPHR causes one PRU to be transferred into the circular buffer. 


The status responses (bits 17 through 0 of FET+0O) are: 


-000001T 
oooo2it 
740031T 


7410311 | 


Macro format: ..- 


Location | 


addr 


READ (010) 


Full sector. 
EOR encountered. 
EOF encountered. 


EOI encountered. 


Operation Variable 


RPHR addr,r 


Address of. the FET. 


Auto recall option; if r is specified, control is not returned to. the 


user program until the operation is complete. 


The READ function reads information into the circular buffer. If there is room in the 
buffer for at least one full physical record, the system initiates reading and continues 


until: 


e The available circular buffer space will not accommodate one full PRU. 


e An end-of-record or end-of-file: is encountered. 


e The end-of-information is encountered. 


e For S. and L format tapes, one PRU is read. 


The status responses (bits 17 through 0 of FET+0) are: 


oooo11t 
000021 
740031T 


7410317 


Buffer filled. 
EOR encountered. 
EOF encountered. 


EOL encountered. . 


{This status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0O at the 
beginning of this section.) 
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Data is not transferred after an EOR or EOF mark is encountered. For tapes that do not have 
a defined EOI (refer to appendix J), an operation that normally would terminate at EOI 


terminates instead at EOF. Also, for S and L format tapes, the unused bit count is returned 
to FET+6, bits 29 through 24, when the read is complete. 


Macro format: 


Location Operation Variable 
READ addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified by r, control is not 


returned to the user program until the operation is complete. 


READSKP (020) 

READSKP performs a read function until the buffer is filled or until an EOR or EOF is 
encountered. If the buffer is filled before an EOR is encountered, CIO positions the file 
at the next EOR, EOF, or EOI, whichever is encountered first. 


The status responses (bits 17 through 0 of FET+0) are:. 


000021t Buffer filled or EOR encountered (file is positioned at beginning of 
next record). 

740031t EOF encountered. 

741031T EOI encountered. 


For tapes that do not have a defined EOI (refer to appendix J), an operation that normally 
terminates at EOI terminates instead at EOF. 


This is the only read function that performs the read operation if less than one PRU of 
space is available in the buffer. 


TThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section.) 
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Macro format: 


Location ' Operation Variable 
READSKP addr,level,r 
addr Address of the FET. 
level . Level number (0 through 17g) specified in FET+0, bits 17 through 14; if 


a level number is specified, information is skipped until the 
eccurrence of an EOR with a level number greater than or equal to the 
one specified: 


0-16, After the buffer is full, skip to the next EOR. 
17g After the buffer is full or a full record is placed in 
the buffer, skip to the next EOF. 


For S$ and L format tapes, only a request with level 17, is recognized; 
any other level in the request is ignored. 


r Auto recall option; if any value is specified by r, control is not 
returned to the user program until the operation is complete. 


For S and L format tapes, the user program should set the mlrs field (FET+6, bits 17 through 
0) before issuing the READSKP function. If mlrs is 0, the system assumes 512 words for an S 


tape and 377777, for an L tape. Thus, if a READSKP is issued on an L tape and mlrs is 0, a 
block too large error occurs if a block is encountered that is larger than 377777, CM words. 


READCW (200) 


Macro format: 


Location Qperation Variable 
READCW addr,level,r 
addr — Address of the FET. 
level Termination level: 
0-16, Continue reading over EOFs (stops at EOI or buffer 


full). EOFs are returned in data as zero length 
blocks with level 179. hi 

17g Stop reading at next EOF. EOF status is returned to 
the FET, but no EOF data block (zero eal and level 
17g) is returned to the CIO buffer. 


xr Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


' 
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The READCW function performs a nonstop read of PRUs bounded by control words. The PRU 
format is: 


59 


54 47 
PRU size block length 
WAL = — WH A= ‘ 


Pp ' Parity error indication (is set for each block in error when reading 
with the ep bit set in the FET). 


fo) Bit 54 is set if coded operation (tape operations only) . 


PRU size Number of CM words in each PRU on the device (refer to appendix J for 
a description of PRU sizes). 


ubc Unused bit count (Q<ubc<i1). Ignored for mass storage files. For I, 
LI, and SI format tapes, ubc must be 0. For F, S, and L format tape 
read and write operations, ubc is processed as accurately as possible 
within the constraints of the hardware. 


block length Count of the number of 12-bit data bytes in the PRU. For mass storage 
files and I, LI, and SI format tapes, it must be equal to five times 
the number of CM words occupied by the data. 


level Logical record level number: 
0-16, The PRU is an EOR. 
17 The PRU is an EOF. 


For mass storage devices the following information is returned: 


est EST ordinal of mass storage device 
tk Track number used 
sc Sector number used 


This function allows the user program to read nonstop and detect EORs and EOFs without 
having to recall CIO for the next sequential read. Reading terminates normally if the 
buffer becomes full or if the EOI is detected. If the request is made with the level number 
equal to 17g (that is, FET+0, bits 17 through 14), reading stops at the next EOF. 


] This function may be used only with mass storage, magnetic tape, and optical disk devices. 
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READLS (210) 


The READLS:- function reads the group of mass storage logical records specified in a list. 
supplied by the user program. The user. program must supply the address of the list in the - 
lower 18 bits of FET+5. READLS continues reading until the list is exhausted or the buffer 
is filled. 


' Macro format: 


Location Operation ' Variable 
READLS addr,r 
addr Address of the FET. 
2 Auto recall option; if any value is specified by r, control is not 


returned to the user program until the operation is complete. 


FET+5 contains the address of the list in the following format. 


r Set by CIO if this is not the initial READLS call. 
la : Address of the list. 


The list is in the following format. 


| LLL 


= 


Wy 
Va 


rsay Random sector address. 


la 
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The status responses (bits 17 through 0 of FET+O) are: 


74003 1T Operation complete. Entire list read. The value of la in FET+5 is set 
to terminator word. 


000211T Operation not complete. la in FET+5 contains the address of the next 
entry of the list to be processed. If the buffer is full, r is set to 
l. If the buffer is not full, CIO has reached an internal limit and has 
stopped processing the list. After emptying the buffer, the user 
program should call CIO again to continue processing the list. 


RPHRLS (230) 


The RPHRLS function reads the group of mass storage PRUs specified by a list supplied by the 
user programe This function performs the same operation as READLS except that each address 
in the list specifies a single PRU instead of a record. After the single PRU specified by 
each list entry is placed in the buffer, the list position is advanced. 


Macro format: 


Location Operation Variable 
RPHRLS addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


. This status response is returned for a coded FET. The status response for a binary FET 


ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section.) 
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READNS (250) ; 


The READNS function. reads a file from the current position to an EOF.. 


The status responses (bits 17 through 0 of FET+0) are: 


000251T Buffer full. 
740031T EOF encountered. 
741031T EOL encountered. ; : 


Macro format: 


Location Operation Variable 
READNS addr,r 
addr ; Address of the FET. 
re - Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


tThis status response is returned for a coded FET., The status response’ for a binary FET 


ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section.) 
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READN (260) 


The READN function reads data from an S or L format tape into the circular buffer. Reading 
continues until one of the following occurs: ; 


e The buffer is full. 
e An EOF is encountered. 
= The EOI is encountered. 
' Status responses (bits 17 through 0 of FET+O) are: 


000261T Buffer full. 
740271T EOF encountered. & 
741271¢ EOL encountered. 


Macro format: 


Location Operation Variable 
READN addr,r 
addr Address of the FET. @ 
r Auto recall option; if any value is specified for r, control-is not 


returned to the user program until the operation is complete. 


Before this function is issued, the mlrs field in FET+6, bits 17 through 0 must be set to 
the largest physical record that will be encountered. For S format, if mirs is 0, the value 
of the maximum block is assumed to be 512 words. For L format, if mlrs is 0, the assumed 
maximum block is (LIMIT-FIRST~2). In addition, the file mode bit (FET+0, bit 1) must be set. 


Each physical record in the circular buffer is preceded by a header word. This word is @ 
generated by the system; it does not exist on the tape. The format of the header word is: 


59 17 ) 


LEE = MUE|_ 


ube Unused bit count. Number of bits in the last word that are not valid 
data; ube may range from 0 to 55. 


block size Number of CM words in the physical record. 
After each complete physical record has been placed in the buffer, the system moves the IN 


pointer to reflect both the header and the data. 


{This status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0O at the 
beginning of this section.) 
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READEI (600) 


The READEI function reads information into the circular buffer. 


EOI mark is encountered or the buffer is filled. Status responses (bits 17 through 0 of 


FET+0) are: 
000601 f Buffer full. ~ 


741031T EOL encountered. 


Macro format: 


Location Operation Variable 
READEL addr,r 
addr Address of the FET. 
r.. Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


CIO WRITE FUNCTIONS 


CIO processes the following write functions. 


On a secured system, performing a write 
function on a mass storage file with an 
access level lower than your job’s current 
access level causes the file’s access level 
to be raised to the level of the job. Such 
a request to a tape or an attached direct 
access file is rejected as a security 
conflict (unless you have special 
authorizations), since the access levels of 
these files cannot be changed while the 


files are attached to a job. 


{This status response is returned for a coded FET. 


The status response for a binary FET 


ends in 3 instead of 1 (refer to the description of the code field of FET+O at the. 


beginning of this section.) 
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Reading continues until an 
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WPHR (004) 


WPHR writes one physical record from the circular buffer. If the buffer contains less than 
one full PRU, no operation occurs. 


Macro format: 


Location Operation Variable 
WPHR addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is rot 


returned to the user program until the operation is complete. 


-WRITE (014) 


WRITE transfers the contents of the circular buffer to the specified file. Writing 


continues until the buffer contains less than one full PRU of data (a WRITER request empties 
the buffer and writes an end-of-record on the file). 


Macro format: 


Location Operation Variable 
WRITE addr,r 
addr Address of the FET. 
r Auto recall option: 
* 


The * option sets the WRITE function code (CIO function 


code 014g) in FET+0 and returns to the calling 
program. The WRITE function is: not performed at this 
time. 


For further information concerning use of the * option, 
refer to WRITECW (204) later in this section. 


other Control is not returned to the user program until the 
operation is complete. 


For S and L format tapes, only one record ig written for each request. The length of the 
record is determined by the value of the IN and OUT pointers. 
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WRITER (024) . ; 


WRITER writes the entire contents of the buffer to the file specified.t The last PRU is 
written as a short PRU (refer to appendix J). If the data exactly fills the last PRU, the 
system adds a PRU with no data to indicate the end of the record. A WRITER request with 
level 17g set in FET+0, bits 17 through 14, performs the same operation as a WRITEF request. 


Macro format: 


Location Operation Variable 
. WRITER addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


WRITEF (034) 


WRITEF writes the entire contents of the buffer to the specified file. The last PRU 
written is the end-of-file. If there is data in the buffer, the system writes the data 
followed by an EOR and an EOF. If the buffer is empty and the last operation was an 
incomplete write (last PRU written was not EOR or EOF), an EOR and an EOF are written; 
otherwise only an EOF is written. For S and L format tapes, data in the buffer is 
transferred to tape and followed by a tape mark. 


Macro format: 


Location Operation Variable 


WRITEF addr,r 
addr Address of the FET. 
xr Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


+ The OUT pointer is updated. The IN pointer is not changed. 
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WRITECW (204) 


The WRITECW function performs a nonstop write of PRUs bounded by control words. ‘The PRUs 
are in the same format as specified for READCW. A level number of 17g on a PRU that 
contains data is ignored. Data written using this function is stored on the device in the 
same format as if it had been written with any other write function (that is, the control 
words are not part of the data). 


WRITECW may be used only with mass storage, magnetic tape, and optical disk devices. 


Macro format: 


Location Qperation Variable 
WRITECW addr,r . 
addr Address of the FET. © 
r Auto recall option: 
* The * option sets the WRITECW function code (CIO 


function code 204g) in FET+0 and returns to the calling 
program. The WRITECW function is not performed at this 
time. 


transfer common deck attempts to issue a write request 
(refer to Data Transfer Macros in this section), it 
will use the CIO request set in the FET instead of a 
WRITE (014g) request. The data transfer common decks, 
by default, issue a WRITE (014g request if WRIF$ is not 
defined). The WRITE macro can be used to reset the FET 
after using the * option with a WRITECW, WRITEN, or 
REWRITE macro. 


If the symbol WRIF$ is defined in assembly and a data @ 


If used, this option should be issued before any 
writing is performed on the file. @ 
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The appropriate data transfer common 
deck must be assembled within the user 
program (that is, the SYSLIB version 
cannot be used) or the WRIFS is 
meaningless. 


For example, the following sequence ensures that the data 
transfer common deck COMCWIW issues a WRITECW request 
instead of a WRITE request if it is required to write the 
circular buffer. 


WRIFS 
OPL 


IDENT WRT 


EQU 


-XTEXT  COMCWTW 


WRITECW F,* 


WRITEW F,WBUF,100B 


FILEB FBUF,2001B,FET=13 


BSS _2001B 
Bss 1008 
END WRT 


Control is not returned to the user program until the 
operation is: complete. : 
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REWRITE (214) 


REWRITE performs the. same operation as the WRITE function with the exception that it causes 
the system to process the operation as a random function; that is, the remainder of the file 
following the portion written is not destroyed. If the random parameters (r, rr, and w) are 
not specified in the FET, the write operation takes place at the current position. If. the 
random parameters rr and w are specified, the normal random addressing procedures are 
followed. The file to be rewritten must reside on mass storage. A subsequent CLOSE 
function will not cause an update of the random index for the file, unless another CIO write 
function has altered the position of EOI since the last OPEN function. 


REWRITE does not ensure that the new record 
being rewritten is not longer than the 
original record. 


Macro format: 


Location ° Operation Variable 
REWRITE addr,r @ 
addr Address of the FET. 
xr Auto recall option: 
* The * option sets the REWRITE function code (CIO 


function code 214g) in FET+O and returns to the 
calling program. No actual REWRITE function is 
performed at this time. 


For further information concerning use of the * option, ; & 
refer to the WRITECW macro. 


other Control is not returned to the user program until the 
operation is complete. 
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REWRITER (224) 


REWRITER performs the same task as WRITER with the exceptions noted for REWRITE. The file 
must reside on mass storage. If the level number is 17g, REWRITER performs ‘the same 
operation as REWRITEF. . : 


‘Macro format: 


Location 


addr 


REWRITEF (234) 


Operation . Variable 


REWRITER addr,r 


Address of the FET. 


Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 


code 


The last PRU is written as a short PRU 
(refer to appendix J). If the data exactly 
fills the last PRU, the system adds a PRU 
with no data to indicate the end of the 
record. 


REWRITEF performs.the same task as WRITEF with the exceptions noted for REWRITE. The file 
specified must reside on mass storage. A subsequent CLOSE function will not cause an update 
of the random index for the file, unless another CIO write function has altered the posresen 
of EOI since the last OPEN function. 


Macro format: 


Location 


addr 
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Operation Variable 


REWRITEF addr,r 


Address of the FET. 


Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. ' 


An extra PRU is written to specify an EOF. 
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OVWRITE (244, 254) 


The OVWRITE macro destroys the existing contents of a mass storage file by writing a 
specified binary pattern of information to the file. The entire file from BOI to EOI is 


rewritten. 


This macro overwrites local files and attached direct access permanent files. In order to. 
overwrite an indirect access permanent file, execute an OVWRITE macro on a local copy of the 
file followed by a REPLACE macro. ; 


Macro format: 
Location 
addr 


pat 


RETURN 
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Operation Variable 


OVWRITE addr, pat, RETURN, r 


Address of the FET. 


The pattern of information to be written to the file. If pat is X, the 
file is first overwritten with binary zeros, then with binary ones, 
then with an alternating pattern of binary ones and zeros. If pat is 
omitted or if any value other than X is specified, the file is 
overwritten with binary zeros. 


If RETURN is specified, CIO function 254 is issued and the file is 
returned after processing. If RETURN is not specified, CIO function 


244 is issued and the file is not returned. 


Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 
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WRITEN (264) 


The WRITEN macro writes nonstop on an S or L formatted magnetic tape. S$ and L formatted 
tapes are described in appendix J. Writing continues until the buffer is empty or 
end-of-reel is encountered. mae 


Macro format: 


Location Operation Variable 
WRITEN addr,r 
@ addr Address of the FET. 
; r Auto recall option: 
* The * option sets the WRITEN function code (CIO function > 


code 264g) in FET+O and returns to the calling 
program. The WRITEN function is not performed at this 
time. 


For further information concerning use of the * option, 
refer to the WEETECH macros 


& other Control is not sepavies to the user program uneit the 
. , operation is complete. 


The user program must provide a header word immediately preceding each record in the 
buffer. This header is not physically written on the tape. Its format is: 


O 


oe 


ubc Unused bit count. Number of bits that are not valid data in the 
| last word; ubc may range from 0 to 55. 


block size Number of CM words in the physical record. 
The system compares the mirs and ube fields in FET+6 Being information from this header. 


The OUT pointer is not changed to reflect the move until after each complete record has been 
written to tape. 
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FILE POSITIONING FUNCTIONS 3 ot 


The following functions control the positioning of a file. If the FET indicates that the 
file is being: accessed randomly, the random address of the new position (cri) is always 
returned. 


Status responses assume coded mode (bit 1 of FET+0 clear). If binary mode is specified (bit 
1 of FET+0 set), the responses end in 3 instead of 1. For example, 041 for coded mode is 
043 for binary mode. 


BKSP (040) 


BKSP causes a file to be backspaced one logical record. If the BOI of the file (or the load 
point of the current volume in a multivolume tape file) is encountered before backspacing is 
complete, even if the file was originally at BOI, a rewind status is returned (05x). If the 
backspace causes the file to be positioned after BOI or exactly at BOI, a backspace status 
is returned (041). 


If the operation terminates on an EOF, 17g is returned to the FET level number (ln) field 
(FET+0, bits 17 through 14). 


Macro format: 


Location Operation Variable 
BKSP addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


Macro format: 


REWIND (050) 


_ BKSPRU (044) 


BKSPRU causes the file to be backspaced the specified number of physical records. If the 
BOI of the file (or the load point of the current volume in a multivolume tape file) is _ 
encountered before backspacing is complete, even if the file was originally at BOI, a rewind 
status is returned (05x).- If the operation causes the file to be positioned after BOI or 
exactly at BOI, the backspace status is returned (045). The skip count is set in the RAtl 
call to CIO. (Refer to the format of the call to CIO.) 


For tape files, if the operation terminates on an EOF, 17g is returned to the FET level 
number (ln) field (FET+0, bits 17 through 14). 


Location Operation Variable 
BKSPRU addr,n,r 
addr Address of the FET. 
n Number of PRUs to backspace. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is. complete. 


REWIND causes a mass storage file to be positioned at BOI. 


‘For tape files that are multifile sets, the file is positioned to the beginning of the 
current file. If. the tape is unlabeled, or if there is only one label at the beginning of 


the tape, a REWIND positions to the beginning of the first file on the tape. 
If the file specified in the FET is not local to the job, no operation is performed. 


In all cases, REWIND resets the IN and OUT pointers in the FET to the value of FIRST. 


Macro format: 


. Location Operation Variable 
REWIND addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


For a mass storage file, if the random processing bit is set in the FET, the current random 
index (cri) is returned as the beginning of the file (random address 1). 
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If the file resides on magnetic tape, the action the system takes depends on the last 1/0 
operation performed. : 


The system responds to a REWIND request as follows: 
1. If the.last operation was a write, one of the following operations is performed. 


e If the tape is labeled, the system writes a tape mark, an EOF] label, and 
three tape marks. 


e If the tape is unlabeled and the data format (refer to appendix J) is S, L, 
or F, the system writes four tape marks. 


e If the tape is unlabeled and the data format is I or SI, the system writes a 
tape mark, an EOF! label, and three tape marks. 


If the last operation was a read, the system proceeds to step 2. 


2. The system rewinds the tape to the beginning of data of the current file. This 
operation is performed automatically even if the current file begins on another reel. 


UNLOAD (060) 


UNLOAD causes the specified file to be rewound and unloaded. If the file resides on mass 
storage, UNLOAD performs the same function as RETURN. For tape files and files residing on 
removable packs, the UNLOAD function does not decrease the number of tape or pack resources 
scheduled for the job via the RESOURC command. 


Macro format: 


Location Operation Variable 
UNLOAD addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


If the file resides on magnetic tape, the action the system takes depends on the last I/0 
operation performed. 
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The system. responds to an UNLOAD request as follows: 


1. If the last operation was a write, one of the following operations is performed. 


e If the tape is labeled, the system writes a tape mark, an EOF] label, and 
three tape marks. 


e If the tape is unlabeled and the data format is $1 or F, the system 
writes four tape marks. : 


e If the tape is unlabeled and the data format is I or SI, the system writes a 
tape mark, an EOF1 label, and three tape marks. 


If the last operation was a read, the system proceeds to step 2. 


2. The system rewinds and unloads the tape. 


RETURN (070) 


RETURN causes the specified file to be released from control of the job. The operation 
performed depends on the type of file. : ; 


Type : Operation 
Input The file name is changed to INPUT*; file space is not released and 
: file INPUT* remains attached to the job as a local file. 
Library Job attachment is released but Pink space remains. 
Permanent File interlock (read/write) is cleared; job attachment is released; 


file space remains (if the file has been purged, the file space may be 
released at this time). 


All others File space and job attachment are released. 


If the file resides on magnetic tape, the RETURN macro performs the same function as the 
UNLOAD macro. In addition, the RETURN of a magnetic tape file or your last direct access 
file for a particular removable disk pack decrements the resource demand count (as scheduled 
by the RESOURC command) only if the total concurrent resource demand (tapes and disk packs) 
has been satisfied. If the file is a deferred routed file (refer to section 7), the file 
space and job attachment are. released. 


Macro format: 


Location Operation Variable 
RETURN addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 
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POSMF (110) 


The POSMF macro opens and/or positions standard ANSI-labeled multifile magnetic tape sets to 
a member of the set. The file to be opened is determined by the contents of the label 
fields of the FET or, if the xl bit is set, the contents of the HDRI1 label in the extended 
label buffer. The relative position of the file within the multifile set is specified by 
the file sequence number field. 


Macro format: 


Location Operation Variable 
POSMF addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


Standard ANSI Labeled Multifile Set Processing 


The PRU size (FET+4, bits 35 through 18) and device type (FET+1, bits 59 through 48) are 
returned to the FET as described in appendix J. The FET length must be at least 15g words. 


A nmultifile set is positioned to read an existing file if the file sequence number in the 
FET is not display code 999. The following restrictions and requirements also apply. 


e The tape is positioned to the first member of the multifile set whose HDR1 fields 
match the HDR] data in FET+11g through FET+14g. Binary zero fields are not 
compared. A nonzero retention cycle is used to calculate an expiration date that is 
compared with that on the tape. If all fields do not match, the search continues. 


e If the explicit or implicit position number is greater than that of the last member 
file (that is, the matching HDR1 was not found), POSMF is terminated, returning an 
end-of-set status (2lg set in bits 13 through 9 of FET+0) and updating the file 
sequence number field in the FET to one greater than that of the last member file. 
The HDRI1 for the last member file is.transferred to the CIO buffer, although IN and 
OUT are not updated. The current job step aborts. 


e If the desired file is located, the HDR1 label is transferred to the CIO buffer, as 
space permits, although the IN and OUT pointers are not updated to reflect the label 
information in the buffer. Actual values read are returned to the label FET fields. 


e All optional labels are ignored. 
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toa 


A multifile set is positioned to write a new file if the file sequence number in the FET is . 
display code 999. Further requirements are as follows: 


e The first file of a multifile set is created if all of. the following are true (refer 
to examples 1 and 2): 


- The tape is positioned to the first file. 
- The last operation was not a write. 


set ID field in the FET must be nonblank if the set is to be extended in the 


= The set ID field in the initial HDR] label on the tape is all blanks (the 
future). 


e The multifile set is positioned to extend the set in-all other cases. The tape is 
| & positioned to after the last file in the multifile set. 


e The system writes a new HDRI label to the tape with the following results. 
- The file sequence number of the new HDR1 label is set to display code 0001 


for the first file, or is set to the last member sequence number plus 1 for 
extended files. , 


- The section number in the HDR1 label is always set to display code 0001. 


. - The set ID is always set to the set ID of the previous member. This ensures 
that the set ID is unique within a multifile set. 
a - With the above exceptions, the information in FET+1lg through FET+14g is 
used to create the HDRI label. The default value is used for any FET HDR1 
field that is binary zero. If a numeric field contains a. nonnumeric valie, 
the job step aborts. | 


- The creation date field in the FET is ignored; the current date is always 
used. 


& Extended Label Multifile Set Processing 


If the FET length is less than 12g words, the job step aborts. 


The PRU size (FET+4, bits 35 through 18) and device type (FET+1, bits 59' through 48) are 
returned to the FET as described in appendix J. 


To avoid a fatal error, an HDR1 label must be present in the extended label buffer (refer to 
extended label processing under the OPEN macro for a description of the extended label 
buffer). 
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A multifile set is positioned to read an existing file if the file sequence number in the 
buffer HDR1 label is not display code 9999. The following requirements also apply. 


The tape is positioned to the first member of the multifile set whose HDR] label 
matches that in the label buffer. Binary zero fields are not compared. If the 
fields do not match, the search continues. 


If the explicit or implicit position number is greater than that of the last member 
file (that is, the matching HDR] was not found), POSMF is terminated, returning an 
end-of-information status (21g in FET+0, bits 13 through 9). 


If the desired file is located, all labels from HDR1 through the next tape mark are 


transferred to the label buffer, as space permits. The user program is responsible 
for verification of additional labels. 


A multifile set is positioned to write a new file if the file sequence number in the buffer 
HDR1 label is display code 9999. Further requirements or restrictions are as follows: 
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The first file of a multifile set is created if all of the following are true (refer 
to examples 1 and 2). 


- The tape is positioned to the first file. 
- The last operation was not a write. 


- The set ID field in the existing HDR1 label on the tape is all blanks (the 
set ID field in the buffer HDR1 label must be nonblank if the set is to be 
extended in the future). 


The multifile set is positioned to extend the set in all other cases. The tape is 
positioned after the last file in the multifile set. 


The system writes a new HDR] label and all additional user labels to the tape with 
the following results. 


- The file sequence number in the HDR1 label of the new file is set to display 
’ code 0001 for the first file or set to the last member sequence number plus 
1 for extended files. 


- The file section number in the HDR! label is always set to display code 0001. 


- The set ID is always set to the set ID of the previous member. This ensures 
that the set ID is unique within a multifile set. 


- With ‘the above exceptions, the information in the extended label buffer is- 
used to generate the HDR1 label on the tape. The default value is used for 
any buffer HDR] field that is binary zero. If a numeric field contains a 
nonnumeric value, the job step aborts. 


The creation date field in the buffer HDR1 label is seen the current 
date is always used. 


- All additional user file header labels (HDR2 through HDR9) and user header 
labels (UHL) in the label buffer are written to the tape. Nonapplicable 
labels are ignored. 
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Example 1: 


le 


26 


BLANK, VSN=TEST , D=RY,MT. 

Creates a labeled tape with SETID defaulted to blanks. 
LABEL, TAPE , VSN=TEST,LB=KL,F=S ,MT. 

Causes tape to be assigned and positioned at file l. 
LGO. 


Executes program where POSMF on file TAPE with recall specified is performed with 
sequence number set to 999 (or 9999) and a nonblank SETID set in the FET (or xl- 
buffer). This causes the first file of the multifile set to be created using the 
label fields specified in the FET (or xl buffer). 


Subsequent POSMFs with sequence number set to 999 (or 9999) cause the file to be 


extended since the SET ID field on the tape is not nonblank. 


Example 2: 


Repeat the preceding example except that a 


LABEL, TAPE, VSN=TEST, SI=TESTAA, F=S ,MT,W. 


@ “is performed at step 2. The POSMF in the third step extends the file set since the 
SETID is nonblank on the tape. , 


Example 3: 


This example deals with a multifile set contained in two volumes with the following 


structure (the structure of multifile labels is outlined in Volume 3, 


Volume I 


A 
V 


, file 1 file 2 
VOL1 HDR{ data EOF! ‘data EOV!I 


Volume IX | VOL! HORI 


System Commands). 
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e The following steps create a multifile set with this structure. 


1. OPEN or LABEL. With section number=l1, sequence number not specified 
(default is 1). 


2. Write data (File set 1). 

3. POSMF With sequence number set to 999. 

4. Write data (Goes over end of reel) (file set 2). 

5. POSMF : With sequence number set to 999. 

6. Write data (File set 3). 

7. REWIND This causes the trailer label at H to be written. The 


tape is then rewound to the beginning of Volume II 
(position E) and then the file is positioned forward to 
G. The tape is not necessarily at load point following 
a rewind of a multifile set member, rather at the start 
of the multifile set member. The only means, at this 
point, to position to the beginning of Volume I is to 
issue a POSMF with sequence number 1. 


r If the multifile is positioned at the end of file set member 2 (F), a rewind 
positions the tape to the beginning of Volume I since file set member 2 begins 
on Volume I, and then positions Volume I to D. 

e By writing over file set member 2, file set member 3 is destroyed. 

e A POSMF 999 followed by a WRITE creates a file set member at I. 


e To copy all three file set members, the following technique may be used. 


1. OPEN with display code 001 (or 0001) sequence number and all other label 
fields binary zero. 


2. READ to EOI. (C) 


3. POSMF with display code 002 (or 0002) sequence number and all other 
label fields binary zero. This positions to next file set member at (D). 


4. READ to EOI. (F) 


5. POSMF with display code 003 (or 0003) sequence number and all other 
label fields binary zero. 


6. READ to EOI. (H) 
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The SI (M) parameter must be present in order to position multifile labels using commands.’ 
If the QN (P) parameter is present, the multifile set is positioned to the file set member 
that matches the specified sequence number. If QN is.not specified and the FI (L) parameter 
is present, the multifile set is positioned to the file set member that matches the file 
identifier specified. If both QN and FI are specified, a match must occur on both sequence. 
number and file identifier. If neither QN nor FI is specified, an OPEN is done instead of a 
POSMF. 7 : 


v 


To extend a multifile set, QN must be set to 9999.T 


Setting the QN parameter to zero advances the pointer to the next multifile. This is not 
true of a LABEL command. 


If the SI parameter is not specified, then file positioning is not done. The R and W 
parameters on the LABEL command are ignored if SI is specified. The exception is if’ the W 

& - parameter is specified and QNX1, and it is the first OPEN on the file, then an OPEN/WRITE is 
performed. 


Although the sequence number field in the HDR1 label is four characters in length, only the 
rightmost three characters are used to differentiate between 999 and another valid sequence 
number. This occurs because on an open (POSMF), the FET field for sequence is only three 
characters. Therefore, if extended labels are not being used, a limit of 998 file set 
members per file set is enforced. , 


& EVICT (114) ee : 


The EVICT macro is similar to the RETURN macro in that it releases file space for the 
specified file. It differs from RETURN in that EVICT does not release the file attachment 
to the job. When an EVICT is performed on a deferred routed queue file (refer to ROUTE 
macro, section 7), all file routing information associated with the file is cleared. 


Macro format: 


@ Location. Operation Variable 
EVICT addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until.the operation is complete. 


The operation that EVICT performs depends on the file type. For the primary file and 

permanent files, all file space except the first track is released, job attachment. remains, 

and an EOI is written on the first sector of the first track. For all other mass storage 

file types, file space is released and job attachment remains. Files for which write 

lockout is set are returned to the system. An EVICT of a tape file performs the same 

functions as the UNLOAD macro. ; : 2 


tWhen a multifile set is extended, the set ID of the new file is always set to the same 
value as the. previous file. This ensures that the set IDs of all set members are. the same. 
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SKIPF (240) 


SKIPF causes the file to be positioned n records forward from the current position. The 
operation terminates when the skip count is satisfied or when EOI is encountered on a mass 


storage file or a tape file. 


The status responses (bits 17 through 0 of FET+0) are: 


0261T Last record skipped was EOR. 
740271T Last record skipped was EOF. 
741271T EOI encountered. 


Macro format: 


Location Operation Variable 
SKIPF addr,n,r 
addr Address of the FET. 
n- Number of records to skip; if n is omitted, 1 is assumed. 
© ., Auto recall option; if r is specified, control is not returned. to the 


user program until the operation is complete. 


SKIPFF (240) 


SKIPFF skips forward the specified number of files. 


The status responses (bits 17 through 0 of FET+0) are: 


740271 Last record skipped was EOF. 


7412717 EOI encountered. 


Macro format: 


Location Operation Variable 
SKIPFF addr,n,r 
addr Address of FET. 
n Number of files to skip; if n is omitted, 1 is assumed. 
r : Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


fThis status response is returned for a coded FET. 


The status response for a binary FET 


ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 


beginning of this section). 
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SKIPEI (240) _ ks 


SKIPEI causes the file to be positioned at EOI. The skip count in RAtl ig set to 77777178 
to indicate a skip to EOI. The status returned in bits 17 through 0 of FET+0 is 741271. On 
tape files where no EOI is defined, the skip operation stops at an EOF. : ; ; 


“Macro format: 


Location Operation Variable 


SKIPEL addr,r 
addr Address of the FET. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


SKIPB (640) 


SKIPB causes the file to be backspaced n logical records. If the BOI of the file (or the 
load point of the current volume in a multivolume tape file) is encountered before 
backspacing is complete, even if the file was originally at BOI, a rewind status (05x) is 
returned. If the file is positioned after BOI or exactly at BOI, backspace status is 
returned (641f). If the skip stops at an EOF, the level number is set to 17g (status 
returned is 740641f). ; 


Macro format: 


Location Operation Variable 
SKIPB addr,n,r 
addr Address of the FET. 
n , Number of records to skip backward. If n is not specified, 1 is. 


1 


assumed. If n=/77777g, file is rewound. 


r Auto recall option; if any value is specified for r, control is not 
returned to the user program until the operation is complete. 


TThis status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of | (refer to the description. of the code field of FET+0O at the 
beginning of this section). 
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SKIPFB (640) 


SKIPFB causes the specified file to be backspaced n files from the current position. If the 
skip count specified is 777777g, the file is rewound. If the BOI of the file (or the load 
point of the current volume in a multivolume tape file) is encountered before backspacing is 
complete, even if the file was originally at BOI, a rewind status (05x) is returned. _ 
Otherwise a skip status (740641T) is returned. . 


Macro format: 


Location Operation Variable 
SKIPFB addr,n,r 
addr Address of the FET. 
n Skip count; if n is omitted, 1 is assumed. 
r Auto recall option; if any value is specified for r, control is not 


returned to the user program until the operation is complete. 


DATA TRANSFER MACROS 


NOS provides a set of macros to assist you in manipulating the following types of data. 
e Data that is to be processed after being read from a file. 
C) Data that is to be written on a file after being processed. 


To use the data transfer macros with the input/output macros, the user program must define 
FETs, input/output circular buffers, and working buffers. The data transfer macros enable 
the user program to copy data from the working buffer to the circular buffer and vice versa 
without having to be concerned with the circular buffer FET pointers. The macros and the 
associated common decks perform all activities involved with the FET pointers. Figure 3-3 
illustrates a typical buffer arrangement. 


In figure 3-3, to copy data from the working buffer to the circular buffer a write data 
transfer macro is used. In this case, data starting at the address of the working buffer is 
copied to the circular buffer starting at address IN. To copy data from the circular buffer 
to the working buffer, a read data transfer macro is used. Then data starting at the 
circular buffer address OUT is copied beginning at the address of the working buffer. 


The working buffer is usually signficantly smaller than the input/output buffer. 


The user program must issue the input/output functions to initiate reading or writing 
between the input/output buffer and the device. However, once the function is issued, the 
common decks called by the data transfer macros initiate the subsequent input/output 
requests required to maintain the data flow until the initial function is completed; that 
is, until an EOR, EOF, or EOI is encountered, depending on the CIO function. 


{This status response is returned for a coded FET. The status response for a binary FET 
ends in 3 instead of 1 (refer to the description of the code field of FET+0 at the 
beginning of this section). 
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circular buffer 


file environment table (FET) 


write : working buffer 


data Pasi , — 
ate nantes | U//} 


space for data 


not used 


Figure 3-3. Data Transfer Buffer Arrangement 


Data transfer read macros return the following information. 


e (Xl) = O if the transfer to the working buffer is complete. 
e (X1) = -1 ‘if an EOF is encountered when reading the file. 
e (Xl) = -2 if an EOI is encountered when reading the file. 


@ (Xl) > O if an EOR is encountered on the file before the transfer to the working 
: buffer is complete; this number is the address plus 1 in the working buffer 
of the last word transferred (equal to B6). 


A CIO read function stops transferring data to the input/output circular buffer when an EOR, 
EOF, or EOI is encountered, unless the CIO function being used specifies, a different. 
termination condition (for example, READEI or READNS). Depending on the CIO read function, 


the EOR and/or EOF status may not be. returned (for example, READEI or READNS). 


Following a data transfer read function, register B6. contains the address plus 1 of the 
working buffer for the last word of- data transferred. 


@ 60459690 A 3-55 


The following sample program rewinds an input file named INP and an output file named OUT 


and copies file INP to file OUT. 


IDENT COPYFIL 
ENTRY COPYFIL 
SYSCOM B1 


*k ASSEMBLY CONSTANTS. 
IBUFL EQU 10018 


OBUFL EQU 2001B 
WBUFL EQU 100B 


INPUT BUFFER LENGTH 
OUTPUT BUFFER LENGTH 
WORKING BUFFER LENGTH 


INITIATE READ OF LOGICAL RECORD 


IF NOT EOR/EOF 
IF EOF OR EOI ENCOUNTERED 


ak FETS. 
I BSS 0 
INP FILEB IBUF,IBUFL 
0 BSS 0 
OUT FILEB OBUF,OBUFL 
ak MAIN PROGRAM. 
COPYFIL S$B1 1 
REWIND 0 
REWIND I 
CcOP1 READ I 
RECALL 0 
COP2 READW I,WBUF,WBUFL 
ZR X1,COP3 
NG X1,COP4 
* EOR ENCOUNTERED. C 


WRITEW 0,WBUF ,X1-WB 


WRITER O 
EQ cOP1 
CoP3 WRITEW 0,WBUF ,WBUFL 
EQ cope 
coP4 SXx1 X1+1 
NG X1,COP5 
WRITEF 0 
EQ coP1 
COP5 ENDRUN 
wk BUFFERS. 
IBUF BSS IBUFL 
OBUF BSS OBUFL 
WBUF BSS WBUFL 


END COPYFIL 
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OPY DATA IN WBUF TO OUTPUT FILE. 


UF WRITE LAST PORTION OF RECORD 
WRITE END-OF-RECORD 
INITIATE READ OF NEXT RECORD 


TRANSFER MORE DATA TO WBUF 


IF EOI ENCOUNTERED 
WRITE END-OF~FILE 
INITIATE READ OF NEXT RECORD 


INPUT BUFFER 
OUTPUT BUFFER 
WORKING BUFFER 


In the previous example, if the RECALL function was not mpect ties for the output file, the 
following steps could occur. . ‘ 


1. The user program issues the REWIND O function. 
2. Since auto recall is not specified, the user program continues to execute. 


3. At some point, the user program issues WRITEW which moves data from WBUF to the 
output buffer (OBUF) starting at the current IN pointer in the FET. The WRITEW 
macro advances the IN pointer to reflect the amount of data transferred into the 
buffer. , 


4. At this point, the system completes the REWIND function and accordingly updates the 
FET IN and OUT pointers to point to FIRST (empty buffer). This destroys the IN 
pointer updated in step 3. The data placed in the buffer is ignored. 


5. On subsequent EOR operations (WRITER), the same situation could occur if the RECALL 
function were placed elsewhere. 


WRITER 0 


. RECALL O must be placed here. 


WRITEW 0,WBUF, WBUFL 


Write requests in the previous example are not issued with auto recall specified because 
other operations (READ, for example) can be performed before it is necessary to have the 
write operation completed. : 


In the previous example, if an EOR or EOF mark is not detected, it is not necessary to 
reissue READ requests to fill the input/output buffer because the data transfer macros and 
associated common decks detect when the buffer threshold is reached. If this threshold is 
reached, a request is issued to CIO by the common deck. This occurs with the READC, READH, 
READS, and READW macros when the empty space in the buffer exceeds the threshold or with the 
WRITEC, WRITEH, WRITES, and WRITEW macros when data in the buffer exceeds the threshold. 

The threshold used is half the buffer size. That is, if the buffer is less than half full, 
a read request is issued; if it is more than half full, a write request is issued. The 
threshold is an empty buffer for read transfers or a full buffer for write transfers if any 
of the. following conditions is met: 


1. The data transfer macro is READO or WRITEO. 
2. The buffer is smaller than 512 (1000g) words. 


3. For read transfers, symbol RDX$ is defined and common deck COMCRDW is assembled with 
the program. 


4. For write transfers, symbol WTXS is defined and common deck COMCWIW is assembled 
with the program. 
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Assuming no EOR or EOF is encountered by the fifth time through the loop, IBUF is less than 


half full since 256 (400g) words were read. 
request to transfer data from file I to circular buffer IBUF. 


The READW function then issues another CIO 
On the ninth time through the 


loop, the WRITEW function issues a WRITE request to file O since OBUF is now more. than half 


full. 


For the data transfer macros, the common decks required for absolute assemblies, in addstfon 
to those specified with each macro, are: 


e comccrIo 


e  COMCSYS 


e COMCWIW for write functions (except WRITEO) 


e@ COMCRDW for read functions (except READO) 


For relocatable assemblies, these decks are satisfied by default from the library SYSLIB. 


SYSLIB also satisfies the common decks specified with each macro. 


In all of the macros described, the following parameter definitions apply. 


addr Address of the FET. 

buf Working buffer address. 

n Working buffer word count. 
READC 


The READC macro reads one coded line from the input/output buffer to the working buffer. 
Data is transferred until the end of the line (0000 in bits 11 through 0) is sensed-or until- 


n words are transferred. 


Macro format: 


Location Operation 
READC 


Common deck required: 
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Variable 


addr, buf ,n 


COMCRDC 


60459690 A 


WRITEC 


The WRITEC macro transfers a coded line image from the working buffer to the Sepub/ output 
buffer. 


‘Macro format: 


Location Operation Variable 
WRITEC addr, buf 


Common deck required: COMCWTC 


READH 


The READH macro reads a coded line with space fill from the input/output buffer to the 
working buffer. Data is transferred until the end of the line (0000 in bits 11 through 0) 


is sensed or until n words are transferred. 


Macro format: 


Location Operation Variable 
READH addr, buf ,n 


Common deck required: COMCRDH 


‘ 


WRITEH 


The WRITEH macro writes. a | Rode line, deleting all trailing spaces, from the working buffer 
to the input/output buffer. 


Macro format: 


Location Operation ‘Variable 
WRITEH addr, buf ,n 


Common deck required: COMCWTH 
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READO 
encountered. 
Macro format: 


Location Operation 


READO 


Common deck required: 


WRITEO 


Macro format: 


Location Operation 
WRITEO 


| Common deck required: 


: READS 


working buffer is blank-filled. 


Macro format: 


Location Operation 


READS 


| Common deck required: 


3-60 


The READO macro reads one word from the input/output buffer to X6.° (Xl)=1 


Variable 


addr 


COMCRDO 


The WRITEO macro writes one word from X6 to the input/output buffer. 


Variable 


addr 


COMCWTO 


if an EOR is 


The READS macro reads a coded line to a character buffer. The words are unpacked and stored - 
in the working buffer, right-justified, one character per word, until the end-of-line byte 
(0000) is detected. If the coded line terminates before n characters are stored, the 


If the value specified for n is the complement of the 


working buffer length, the working buffer is not blank-filled..- 


Variable 


addr ,buf ,n 


COMCRDS 
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WRITES 


The WRITES macro writes a coded line from the character buffer. The character buffer 
assumed to be one character per word, right-justified. The characters are packed 10 
characters per word. Trailing spaces are deleted before the characters are packed. 


Macro. format: ; : : ; 


Location Operation Variable 


WRITES addr ,buf ,n 


Common deck required: COMCWTS 


READW 


The READW macro transfers n words to the working buffer from an input/output circular 


buffer. READW reads ahead in the input/output buffer. This could cause the program to 
abort if the last word address of the input/output buffer is within four words of the FL. 


The n parameter must be. specified. 
Macro format: 


Location Operation Variable 


READW . addr ,buf ,n 


Common deck required: COMCRDW 


WRITEW 


is 


The WRITEW macro copies data from the working buffer to the input/output circular buffer. 
WRITEW writes ahead in the input/output buffer. This could cause the program to abort if 
the last word address of the input/output buffer is within four words of the FL. If n is 
greater than the length of buf, WRITEW reads beyond the end of the working buffer. The n 


parameter must be specified. 


Macro format: 


Location Operation Variable 


" WRITEW addr ,buf ,n 


Common deck required: COMCWIW 
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CYBER RECORD MANAGER I/O 


CYBER Record Manager (CRM) consists of a group of routines providing input/output facilities 


common to several products. User programs written in several higher level languages (for 
example, COBOL and FORTRAN) can communicate with the Record Manager through compiler 
language calls. COMPASS users communicate through Record Manager macros. 
Features of the CRM include the following: 

e Consistent error checking. 

e Accommodation for label checking. 

e Support of several file organizations. 
CYBER Record Manager supports the following file organizations. 

@ Sequential files in physical order. 


e Word addressable files on mass storage with continuous nonblocked data. 


e Indexed sequential files in which records are physically and logically ordered by 
symbolic keys. 


® Direct access files containing records in fixed length blocks; record location is 
determined by hashing a key to identify a block. 


e Actual key files in which each record is stored in a location specified by the “bey 


associated with that record. 


For a complete description of COMPASS macros, file organizations, and record and block 
formats supported by CRM, refer to the CYBER Record Manager Basic Access Methods and 
Advanced Access Methods reference manuals. 
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LOCAL FILE MANAGER 4 


Local file manager (LFM) performs requests associated with the control of the files assigned - 
to your job. 


The format of the call to LFM is: 


: o 59 40 35 23 17 0 
raety umm RA cote te Tatar 
R _Auto recall bit. 
code Function code. 
fp ' Function parameter. 
addr Address of the FET. 


All LFM requests use the following information from the FET. Some requests use additional 
fields; these are noted in the descriptions of the individual requests. a 


59 47 44 2 17 ie) 


ah) en en i 
al i 7 Cid 


1lfn Local file name. 

c Completion bit. 

dt Device type. 

ep Error processing bit. 


After the request is completed, the first word of the FET contains the following information. 


59 : 17 9 


5 
rere YN 
1fn Local file name. 
at Abnormal termination code. 
c Completion bit. 


The common decks required in absolute assemblies for the macros processed by LFM are: 
e  COMCLIM. 
e COMCSYS. 
For relocatable assemblies, these decks are satisfied. by default from the library SYSLIB. 
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ERROR PROCESSING 


The user program can issue requests to LFM and have control returned if certain error 
conditions occur. To do this, the error processor bit (ep) must be specified in FET+l. The 
following error codes are returned in the abnormal termination (at) code field of FET+0, 
bits 17 through 10. 


Error Code Error Code 


(Octal) Description (Octal) Description 
1 File not found : . 16 1/0 sequence error 
2 File name error ; 17 Reserved for future use 
3 Illegal file type . 20 Reserved for future use 
4 File empty 210 No mass storage available 
5 Magnetic tape subsystem not active 22 Invalid file mode 
6 Reserved for future use 23 FET too short 
7 Illegal equipment 24 GETFNT table too large 
10 Equipment not available 25 Reserved for future use 
ll Duplicate file name 26 Parameter block busy 
12 Invalid user access 27 Address out of range 
13 Access level not valid for file 30 System error 
14 Reserved for future use 31 Invalid random address 
15 Resource executive (RESEX) 32 Reserved for future use 

detected an error 33 Invalid file status 


RENAME (000) 


The RENAME function enables the user program to change the local file name of a file 
currently assigned to the job. The current local file name must be specified in FET+0 and 
the new local file name must be specified in FET+6. RENAME also changes FET+0 to contain 
the new file name after the function executes. Note that RENAME does not change the name of 
the file in the permanent file catalog. 


If a file by the new file name already exists, that file is returned to the system. If the 


returned file was the primary file (type PIFT). and the old file was local (type LOFT), the 
file type of the new file will be PTFT. File types are listed in appendix E. 


Macro format: 


Location Operation Variable 
RENAME addr ,nfn 
addr Address of the FET. 
nfn New file name. 
Value Description 
Xl Xl contains the new file name. 
Other Address of word containing new file name. 


Not specified FET+6 contains the new file name. 
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SETFS (003) 


The SETFS function sets the specified status on a file. 


. Macro format: 


Location 


| ; addr 


fs 


addr 


al 


TThis macro 
PSSTEXT or 
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Location 


‘Operation Variable 


SETFS addr,fs 


“Address of the FET for the file. 


File status. 


Value 


AD 


_ NAD 


Other 


- SETFAL (007) 


The SETFAL macro sets the security access level of a local file to the specified level. The 
file must be a mass storage file and may not be a direct access permanent file (use the 
& SETPFAL macro for permanent files). 


Macro format :t 


Description 


Auto drop status. A file with auto drop status is 
automatically released when a CLEAR, NEW, OLD, 
RETURN(*), or UNLOAD(*) command is issued, unless’ 
otherwise specified in the command. All of your files 
have auto drop status set unless you’ set no auto drop 
status. 


No auto drop status. A file with no auto drop status is 
not automatically released by a CLEAR, NEW, OLD, 
RETURN(*), or UNLOAD(*) command. 


Other file status values are defined in system OPL 
common deck COMSLFD. 


This macro requires the system OPL common. deck COMSMLS.° 


+ 


Operation Variable 


SETFAL ~ addr,al. 


Address of the FET for the file. 


Security access level to be assigned to the file. al can be either the 
name of the access level to be assigned or the address of a word 

-containing the numerical value of a security access level, right- 
justified with binary zero fill. On a secured system, the access level 
specified must be valid for your job (refer to Security Access. Levels 
in section 1) and valid for the device on which the file resides. 


is not available in SYSTEXT. The user program must specify systems text 
call common deck -COMCMAC. ; 
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LOCK (010) 


This function enables the user program to prevent writing on a file by setting the write 
lockout bit for the file. The file specified must be a local or primary type file, and must 
not be in execute-only mode. 


Macro format: 


Location Operation Variable 
LOCK addr 
addr Address of the FET. 


UNLOCK (011) 


The UNLOCK function clears the write lockout bit for the specified file. The file must be a 
local or primary type file, and must not be in execute-only mode. ; 


Macro format: 


Location Operation Variable 
UNLOCK addr 
addr Address of the FET. 


STATUS (012) 


The STATUS macro determines if a file exists. Zero is returned in bits 11 through 1 of 
FET+0 if the file is not found. A nonzero quantity is returned in bits 11 through 1 if the 
file is found. To determine the current position and status of a file, use STATUS (013). 


Macro format: 


Location Operation Variable 
STATUS addr 
addr Address of the FET. 
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STATUS (013) 


This function returns the current position and status of a mass storage or magnetic tape 
file. This function can be used to determine the current position of the file, the type of 
file, and the device on which it resides. 


The device type is returned in bits 59 through 48 of FET+1 (refer to appendix ma bit 59 is 
set if the device is a nonmass storage and nonallocatable device. 


If the access level bit (bit 39) is set in FET+1, the access level of the file is returned 
in bits 38 through 36 of FET+4. 


The FNT word of the local FNT entry of the file is returned in FET+5; the FST word of the 
local FNT entry of the file is returned in FET+6. The format of the local FNT entry is 
described in the NOS 2 Systems Programmer’s Instant. 


NOS does not return the previous function code from bits 11 through 0 of the FST word. 


Instead, the following status information is returned to the FET. 


Bit(s Description 
11 Set if labeled tape. 
10-9 Not used. 
8 Set if the file is opened. 
7 Set if the file is written on since last opened. ‘ 
6 Set if the file is written on since attachment or creation. : 
5-4 Not used. 
3-2 If the last operation was a read: 
0. Incomplete (buffer full). 
1 EOR encountered. 
2 EOF encountered. 
3 BOI encountered. 


If the last operation was a file positioning or write operation: 


t 


0 “Incomplete (no EOR/EOF or buffer exhausted) . 
1 Complete. 

1 Set if the last operation was a write. 

0 Set if the file is not busy. 


60459690 C 4-5 


Macro format: 


Location 


addr 


Operation 


STATUS 


Variable 


addr,p,t 


Address of the FET. 


If P is specified, the current position is returned. 
is omitted, LFM function 12 is executed. 


If this parameter 


If T is specified and the FET is at least 11g words long, the following 
information is returned to FET+10g for tape files. 


Bit (s) 


58 
57 
56-55 


53-51 
50-48 
47-36 
35-30 
29-24 
23-0 


REQUEST (014) 


The REQUEST function requests operator assignment of equipment to a file. 
already assigned, the function is ignored. If dt in FET+1 is nonzero, the 


is of that type. 


Description 


Set if NOS labels are on tape. 


Set if nonstandard labels are on tape. 


Tape type.f 
0 Seven-track (MT). 
1 Cartridge for CTS (CT). 
2 Nine-track (NT). 
4 Cartridge for ACS (AT). 


Density.T 
Conversion mode .t 
Processing options.t 
Format .f 

Noise size. 

Block size.t 


If the file is 
device assigned 


If dt equals MS, a mass storage device must be assigned. The REQUEST 
function cannot be used to assign tape equipment. 


If dt is zero, operator assignment of tape equipment is rejected and operator request for 


equipment continues until an acceptable device is assigned. 


for tape requests. 


The LABEL macro should be used 


No special validation is required to assign allocatable devices such as mass storage or null 
equipment. All other equipment requires you to be validated to use nonallocatable 


devices .ft 


If the access level bit (bit 39 of FET+1) is set, the file is created with the access level 


from bits 38 through 36 of FET+4. 


On a secured system, this level must be valid for your 


job. If the access level bit is not specified, the file is created with no access level on 
an unsecured system; on a secured system, the file is created with your job’s current access 


level. 


On a secured system, operator assignment of an equipment that does not support the access 


level of the file 


is rejected. 


{ For further information about this field, refer to the LABEL macro description. 
ff Refer to the LIMITS command in Volume 3, System Commands. 
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Macro format: 


Location Qperation Variabie 
REQUEST addr, ,n 
addr Address of the FET. 

n If this parameter is specified (any value may be used), the dayfile 


message indicating the equipment to which the file was aueigned will 
not be issued. 


If REQUEST is to be used to checkpoint dumps, FET+7 specifies the checkpoint mode. 


cm Checkpoint f mode indicates that addr is to be used as a checkpoint file: 
758 Each time a checkpoint dump is taken, the new information is 
written at the BOI of addr. 
768 Each time a checkpoint dump is eaeen, the new information is 


written at the previous EOI of addr. 


The user program can alternately write dumps on two checkpoint files by issuing two REQUEST 
macros with cm=75g. If cm=76g for alternate files or if more than two checkpoint files are 


specified, the job step aborts. 
, 


On a secured system, the checkpoint file must be 
assigned an access level equal to the upper 
access level limit of your job. 


REQUEST (015) 


This function assigns a file to a device according to the contents of the device type field 
in FET+1. If the file already exists, the job step aborts. 


The device type (dt) field affects the file’s assignment as follows: 


If dt is LFM assigns file to 
DB 885-42 Disk Storage Subsystem 
pce 895 Disk Storage Subsystem 
DD 834 Disk Storage Subsystem 
DE Extended Memory 
DF 887 Disk Storage Subsystem, 4K Sector ¥ 
DG 836 Disk Storage Subsystem 
DH ‘887 Disk Storage Subsystem, 16K Sector | 
DI 844-21 Disk Storage Subsystem (half-track) 
DI 844-41/44 Disk Storage Subsystem (half-track) 


} For further information, refer to the description of the CHECKPT macro in section 10. 
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one for parity 

Input files 

Binary (executable) files 
Local files 


If dt is LFM assigns file to device of preferred residence for 


DK 844-21 Disk Storage Subsystem (full-track) 

DL 844-41/44 Disk Storage Subsystem (full-track) 

DM 885-11/12 Disk Storage Subsystem (half-track) 

DN 9853 Disk Storage Subsystem 

DP Distributive Data Path to Extended Memory 

DQ 885-11/12 Disk Storage Subsystem (full-track) 

DV 819 Disk Storage Subsystem (single-density) 

DW 819 Disk Storage Subsystem (double-density) 

EBA 5830 Disk Array Subsystem; one 5832 SSD drive used in serial mode 

EB 5830 Disk Array Subsystem; two 5832 SSD drives used in parallel mode 

EC 5830 Disk Array Subsystem; one 5833 SABRE drive used in serial mode 

ED 5830 Disk Array Subsystem; two 5833 SABRE drives: one for data and one 
for parity 

EE 5830 Disk Array Subsystem; two 5833 SABRE drives used in parallel mode 

EF 5830 Disk Array Subsystem; three 5833 SABRE drives: two for data and 


Any allocatable mass storage device 


Output files 
Primary files 


IN 
LG 
LO 
MS 
NE Null equipment 
oT 
PY 
TP Temporary files 
TT 


temporary file devices. 


The terminal (interactive jobs only) 


The device of preferred residence for each of these file categories is determined by the 
site and is not subject to user program control. The mass storage devices must also be 


If the device type field contains a numeric value of the form 7nnng, the file will be 
assigned to EST ordinal nnn. Special validation is required to use this form of the 


request, and nnn must be the EST ordinal of a valid mass storage device. 


The LABEL macro (described in this section) should be used for tape requests. 


| If the access level bit (bit 39 of FET+1) is set, the file is created with the access level 


level. 


the request is rejected. 


from bits 38 through 36 of FET+4. On a secured system, this level must be valid for your 
job. If the access level bit is not specified, the file is created with no access level on 
| . an unsecured system; on a secured system, the file is created with your job’s current access 


| On a secured system, the system selects a device that supports the access level of the file 
and also meets all of the other specified criteria for the file. If no such device exists, 
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Macro format: 


Location 


addr 
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Operation Variable 
REQUEST addr,u,n 


Address of the FET. 


If this parameter is specified (any value may be used), the device type 
in FET+1 is the device to which the file is assigned. Absence of this 
parameter causes LFM function 014 to be issued. ; 


+ 


If this parameter is specified (any value may be used), the dayfile 
message indicating the device to which the file was assigned will not 
be issued. 


4-8.1/4-8.2 | 


ASSIGN (020) : ee 


This function is used to access a library file. If the file is accessed froma system or 
library file, the return status code equals 0. . : 


The random address of the directory is stored in FET+t6. 
The address bias for the AI RORE OES is stored in FET+7. 


This function enables the user program to access user libraries that‘exist' either on» ‘files 
attached to the job or the system. The local files are searched first. Because of the ; 
structure of the system file, the address bias for the directory must be specified. For 
example, if the directory for SYSLIB is specified at random address 2000 (FET+6) on the 
system file, the bias for all entries in this directory-is 1777 (FET+7). This is the 


_address to be added to the random addresses of all routines*in this cTSestory: to access the 


HO ee 


' Macro format: 


routines from the system library. 


If the file specified is a system procedure file, the sign bit in FET+7 is set. If the file 
specified is not a system file, FET+6 and FET+7 are returned as zero. If the file. specified - 
is a relocatable file, FET+6 and FET+7 are unchanged. 


Location: Operation . Variable 
ASSIGN: addryL' 
addr — Address of the FET. 

L This parameter must be specified. 
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ENCSF (022) 


This function replaces the command file. If the file is not defined, the command file is 
cleared. ; : 


Macro format: 


Location Operation Variable 
ENCSF addr, restore 
addr Address of the FET for the file that is to replace the current command 
file. : 
restore ' Address of word containing information on position of the current 


command file; optional parameter. 


If the restore option is selected, the location must be in the following format. 


59 35 29 5 0 
restore | ceo | _carrentrandom accross | we | 
ec Command count. 
we Word count position in current sector. 


PSCSF (023) — 


This function gives the user program the ability to control the execution of the job 
commands by positioning to the next command in the command file to be executed. 


Macro format:t 


Location Operation Variable 
PSCSF addr 
addr Address of the FET for the request. 


FET+6 contains the parameters in the following format: : 
47 : 23 : ie) 


ce Command count. 


we ’ Word count from the beginning of the file; if the word count specified 
exceeds the length of the file, the file is positioned at the beginning. 


fThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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LABEL (024) 


The LABEL macro assigns a file to magnetic tape and processes labeled and unlabeled tapes. 
LABEL uses the information in FET+10g through FET+15g to create new and access existing 


seven- or nine-track tape files. 


FET +10 
+11 
+12 
+43 
+14 
+15 


Flags 
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$9 


Parameter 


53. 
onto 


NOTE 


The FET information is defined as follows: 


On systems using the Tape Management System . 
(TS), the FET information is defined 
differently. For a description of the FET 
information for the LABEL macro under TMS 
processing, refer to the NOS 2 Tape Management 
System (TMS) User Reference Manual. 


47 


Word 
(FET+n) 


10g 


29 23 


35 
re ed 
file identifier (first 10 characters) 
file identifier (last 7 characters) 


Position 


59 


14 0 


N 


N 


Ziv soasnce van 


Description 


Read/write (rw) flag. Specifies the 
type of label processing to be 
performed. This bit is set if an 
OPEN/WRITE is to be performed; it is 
not set if an OPEN/ALTER is to be 


“performed. 


For multifile set tapes, if the set 
identifier is specified and a file 
sequence number greater than 1 is 
specified, a POSMF is performed to 
position the tape to the requested 
multifile set. If the file sequence 
number is 9999, write mode is forced 
and the multifile set tape is 
extended. 


: Word 
Parameter (FET+n) Position 
58 
57 
56-55 
Density (den) 10g 53-51 
Conversion mode (cv) 10g 50-48 


Description 


Label (1b) flag. 


If this bit is set, 


the tape is labeled or is to be 
labeled. If this bit is not set, the 
tape is unlabeled. 


Nonstandard (ns) flag. 


If this bit 


is set, the tape has or is to have 
nonstandard labels. 
not set and bit 58 is set, the file 
is or is to be an ANSI-labeled tape. 


Tape type: 


WNEH © 


Tape density: 


0 
1 556 cpi 
2 200 epi 
3 800 cpi 
800 cpi 
4 1600 cpi 
5 6250 cpi 
6 38000 cpi 


Seven-track (MT). 
Cartridge for CTS (CT). 
Nine-track (NT) . 
Cartridge for ACS (AT). 


Installation default. 


(MT) . 
(MT) . 
(MT) 
or 
(NT) . 
(NT) . 
(NT) . 


(CT or AT). 


Conversion mode: 


If this bit is 


(0) Installation default. 
1 ASCII conversion (nine- 
track). 
2 EBCDIC conversion (nine- 
track). 
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Parameter 


Processing option (po) 


- error processing bit is not set.- 


Word 
(FET+n) Position 
10g 47-36 
Bit Set 


a. 36 


37 


38 


39 


40 


Description 


Processing options:! © 


Description 


Abort on an unrecoverable 
read or write parity error 
even if the error processing 
bit is set. 


Do not abort on an 
unrecoverable read or write 
parity error regardless of 
the error processing bit. 


Inhibit error processing. 
If the tape is mounted with 
the write ring in, job 
processing is suspended 
until the operator remounts 
the tape correctly. 


If the tape is mounted with 
the. write ring out, job 
processing is suspended 
until the operator remounts 
the tape correctly. 


- tT If neither bit 36, 37, nor 38 is set, abort. on read or write parity error only if the 
For further information about these processing epeious 


xefer to.the Equipment/File Assignment Commands in Volume 3, System Commands. - 
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oe 


Parameter 


Processing option (po) 


Word 
(FET+n) 


- 10g 


47-36 


Description 


Processing options:. 


Bit Set 
(Contd) - 


41 


42 


Description 


Do not unload tape at end of 
usage. ; 


If set, toggles installation 
default setting of the flag 
that controls error 
correction activity in GE 
(6250 cpi) write mode. 
(Contact installation 
personnel to determine the 
default setting.) The 
setting selected is returned 
after tape assignment is 
complete. If the 
installation default is 0 
(allow error correction) and 
the user program does not 
toggle it or if the 
installation default is 1 
(disable error correction) 
and the user program toggles 
it, a value of 0 is returned, 
indicating that hardware 
error correction is enabled. 
In this mode of operation, 
the system allows certain 
types of single-track errors 
to be written that can be 
corrected when the tape is 
read (on-the-fly correction). 
This is the recommended 
setting because it provides 
efficient throughput, error 
recovery, and tape usage when 
writing GE tapes on media 
that are suitable for use at 
3200 fci or 6250 cpi. If the 
installation default is 1 and 
the user program does not 
toggle it, or if the 
installation default is 0 and 
the user program toggles it, 
a value of 1 is returned, 
indicating that hardware 
error correction is disabled. 
The system invokes standard 
error recovery processing 
when an on-the-fly error 
occurs when writing a GE 
tape, thereby. reducing the 
amount of data that can be 
stored on the tape. 
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Parameter 


Processing option (po) 


Word 


(FET+n) 


10g 


Position 


47-36 


Description 


Processing options: 


Bit Set 


(Contd) 


42 


43 


44 


Description 


Only tape that is suitable for 
recording at 6250 cpi should 
be used when this mode of 
operation is in effect. Refer 
to processing options G and H 
in Volume 3, System Commands, 
for further information. 


If set, toggles installation 
default setting of the flag 
that controls the issuing of 
tape detailed status error 
messages to the user control 
point dayfile. (Contact 
installation personnel to 
determine the default 
setting.) The setting 
selected is returned after the 
tape assignment is complete. 
If the installation default 
for the setting is 1 (issue a 
message to the user dayfile 
for both the first and the 
last attempt to read or write 
a bad tape block) and the user 
program does not toggle it, or 
if the installation default 
for the setting is 0 (do not 
issue the detailed status 
messages to user dayfile) and 
the user program toggles it, a 
value of 1 is returned, 
indicating that a message is 
to be issued to the user 
control point dayfile for both 
the first and the last 

attempt to read or write a 

bad tape block. If the 
installation default for the 
setting is 0 and the user 
program does not toggle it, or 
if the installation default 
for the setting is 1 and the 
user program toggles it, a 
value of 0 is returned, 
indicating that no tape 
detailed status error messages 
are issued to the user 
dayfile. 


Not used. 
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Word | 
Parameter (FET+n) Position 
Processing option (po) “X0g 47-36 
(Contd) 
Data format (f) 10g 35-30 
r 
Noise : : 10, 29-24 
Block size (PRU size) 10g 23-0 
Volume serial number 1lg 59-24 


appendix J. 
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| 


Description 


Processing options: 


Bit Set Description 


47-45 These bits define the end-of- 
tape/end-of-volume conditions 
and are defined as follows: 


Bit 47 Bit 46 Bit 45 Optiont 


3 

2 

1 
Default 
option 
selected 
according 
to format 


orOoOO 
oorO 
oooFrF 


Other combinations are 
illegal. 


Data format (refer to tape data 
formats in Volume 3, System Commands) : 


Value Data Format f 


Internal (I) 

System internal (SI) 
Foreign (F) 

Stranger (S) 

Long block stranger (L) 
Long block internal (LI) 


Ut WN O 


LI format is valid only for CT, AT, 
and 6250-cpi NT tapes. 


Noise size in frames; any block 
containing fewer than the specified 
number of frames is considered noise 
and is discarded by the system (refer 
to appendix J). A noise specification 
of zero specifies the default noise 
size. 


Maximum block size in frames (refer to 
appendix J). 


One to six display-code characters, 
left-justified with blank fill, that 
uniquely identify a volume of tape 
(refer to ANSI Tape Label Formats, 
Volume i Label, and VSN Command in 
Volume 3, System Commands). For a VSN 
of SCRATCH, specify all blanks. 


J For more information, see options 1 through 3 in End-of -Tape/End- of -Volume Conditions, 


Word 
Parameter (FET+n) Position Description 

File accessibility (fa) llg 23-18 One display code character indicating 
who may access the tape file.f 

File section number 11g 14-0 Fifteen-bit binary file section 
number .f 

File identifier 12g 59-0 File identifier (first 10 display- 
code characters, left-justified with 
blank fill) .f 

File identifier 13g 59-18 File identifier (last seven display- 
code characters, left-justified with 
blank fill) .f 

File sequence number 13g 14-0 Fifteen-bit binary file sequence 
number .{ 

Set identifier 14, 59-24 Six display-code characters 
specifying the multiple set 
identifier, left-justified with blank 
fill.t 

Generation version 14, 23-15 Nine-bit binary generation version 

number (gvn) number .f 

Generation number 14, 14-0 Fifteen-bit binary generation 
number. Tt 

Expiration date 183 59-30 Five display-code characters 
specifying the expiration date. 

Creation date 15g 29-0 Creation date (two-digit numeric 


display code value for the year 
followed by a three-digit numeric 
display code value for the day within 
the year). 


The specified file is assigned to tape automatically if the volume serial number is 
specified either in FET+1llg or in a VSN command. If the VSN in FET+1lg is zero and no VSN 
command for the file was included, the system requests the operator to assign a unit. 


If dt in FET+1 is MT, NT, CT, or AT, a tape unit must be assigned; no other specification is 
allowed. However, if dt is zero, the operator can assign any device and the user must be 
validated for this device. If the operator assigns a tape equipment when dt is zero, only a 
nine-track unit is accepted if the tape device type, density, or conversion mode implies 
nine-track; only a seven-track tape unit is accepted if the density implies seven-track. If 
both the tape device type and the density fields are zero, any kind of tape unit can be 
assigned. 


If the access level bit (bit 39) is set in PET+1, the access level in FET+4 is assigned to 
the file. On a secured system, the tape must be mounted on a unit that supports this level. 


For ANSI labeled tapes, FET+1llg through FET+15g contain the values LABEL uses to process 
HDR1 labels. 


} Refer to appendix J. 
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Macro format: 


Location Operation Variable 
LABEL addr 
a 
addr Address of the FET. 


If a local file with the specified file name already exists (other than a VSN: entry for the 
file), no assignment is made and job processing continues. An OPEN or POSMF is not :. 
performed to reposition an existing tape file. To assign the file to-tape, the user. program 


' should return the existing file to the system before issuing the LABEL request. 


If the file is to be used for checkpoint dumps, the checkpoint mode can be specified in 
FET+7, bits 59 through 56. Refer to the format of FET+7 in the REQUEST macro (function 014). 


Example: 


' The following example assigns a file to magnetic tape. The program performs the same 
function in assigning the tape as the following command. 


LABEL , TAPE] , VSN=NOSVSN , PO=R, D=HY ,F=1. 


‘The tape is seven-track; 800 cpi, I. format. The program reads file TAPEl. 


BUFL EQU 
FET BSS 
TAPE1 ’ FILEB 
, ORG 
FET8 _ VED 
FET9 VFD 
VFD 
VED 
VFD 
: VFD 
BUF BSS 
LABEL 
READ . 
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30018 
0 
BUF ,BUFL,LBL 


FET+8 


6/20B,3/3,3/0,12/108,6/0,6/0,24/1000B 
36/0HNOSVSN,24/0 

60/0 

60/0 | 

60/0 

60/0 

BUFL 


FET 


GETFNT (025) 


The GEIFNT macro generates a table of entries for local files based on the files’ local file 
name table (FNT) entries. 


NOS supports two formats of the GETFNT macro. The format is selected by the setting of bit 


21, FET+10g, Format A is selected by setting bit 21 to zero; format B is selected by 
setting bit 21 to one. 


Format A allows the user program to optionally specify that file status table (FST) 
information is to be converted to the current current random index or the file length for 


mass storage files, or to the block number for tape files. Format B provides all of the 
information that is optional in format A. 


Format A returns a table of limited length; this length is specified in FET+10g. Format B 
fills a buffer whose length is specified in FET+10g with a number of entries, and allows 


the user program to issue a continuation macro call to obtain further entries. & 


You are encouraged to use format B for all 
new programs and to convert existing programs 
to format B. Format A will not be supported 
in future NOS releases. 
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Macro format: f . : 2 oe Ye ot re 


Location Operation . Variable 


“ GETFNT addr 
addr’ ‘Address of the FET. x 


'GETFNT obtains its input parameters’ from FET+10g, in the following ‘format. 


59 at = 2317 a) 


: 47 - 
Cr E/E | 


nf - Maximum number of two-word entries’ to be returned to table. For format 
A,‘table size must be at least (nf*2+1) words;.for format B, table size 
must be at least (nf*2+2) words. Default is 200g entries. 
sb File type selection bits. A bit set to one implies the corresponding 
‘" file type is selected for entry into the table.. All bits set to zero 
indicates selection of all file types. Bit positions and corresponding 
' file types are as follows: , 


Bit File Typeft "- "Description 
41 -— Unused. ~ ~ oo ‘ 
37 LOFT Local. 

36 SYFT System. 

35 FAFT Fast attach file. 

34 PMFT Direct access permanent file. 
33 PTFT - Primary terminal. 

32 LIFT Library. i 

31 = : Reserved. 

30 == Reserved. 

29 QFFT Queued file. 

28. TEFT Timed/event rollout. 

27 PHQT -° Punch queued file. 

26 PRQT Print queued file. 

25 ROFT.. Rollout. 


24 INFT © Input.: 


. TThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common: deck COMCMAC (refer to appendix F).. ‘ 
{TFile types are explained in appendix E. : 
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cb Control bits: 
| Bit(s) 
23-22 


21 


20 


19 


18 


Significance 


Unused. 


If bit 21 is set, format B is returned; otherwise, format 
Ais returned. Bits 18 and 19 are ignored if this bit is 
set. . 


If bit 20 is set, checkpoint file entries are returned to 
the table (FET length must be at least 1lg words). If 
bit 20 is not set (0), the FNT words of checkpoint file 
entries are returned in FET+1lg, instead of the table 
(FET length must be at least 15g words). 


If bit 19 is set, mass storage file FST entries are 
modified with file lengths in bytes 2 and 3. If bit 19 
is not set, the FST entry is modified with random index 
in bytes 2.and 3. Bit 18 must be 0 or bit 19 is ignored. 
Bit 19 is ignored if bit 21 is set. 


If bit .18 is set, no modifications are made on the FST 
words of the entries. If bit 18 is not set, pertinent 
modifications are made (such as the block number for tape 
files or that specified by bit. 19 for mass storage BARES) 
Bit 18 is ignored if bit 21 is set. : 


ta ’ Address of table. 


The format A table has the following format. 


ta+(n—1) 


ta+n 


first file entry word 0 
first file entry word 1 


last file entry word 0 : 
last file entry word 1 ; 
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Each format A 


‘word 0 


word 1 __ 


mode 


type 


status 
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file entry has the following format. 
59 47 : : - 7 °° 


Mode of use allowed for the file. 


Bit(s) ' Description 
17 Not used. ° 
16 Set if extend-only file. 
15 Set if alter-only file. 
14 Set if execute-only file. 
13 Not used. 
12. Set if write lockout is present. 


The file permission mode in which the file was attached is 
by the values of bits 16, 15, 14, and 12, as follows: 


Mode : Bits Set 
Write None 
Read 12 
Append ~ > 16 
Execute -14, 12 
Modify 16, 15 


Read, allow modify 16, 15, 12 
. Read, allow append 16, 12 

Update 15 

Read, allow update 15, 12 


File type. 
Value ; 
(Octal) Description 
7 Rollout. 
10 Library. 
ll Primary terminal. 
12, Direct access permanent file.’ 
“13°. «Fast attach. 
14 System. 
15 ‘Local. 
16 Reserved. 
17 Input. 
20 Queued file.« 
Status of file. 
Value Description 
0 Auto drop status. 
1 _User file privacy status. 
2 Special system jobfile status. 
- 3 CB checkpoint file status. 
4 CK checkpoint file status. 
5 Special output file status. 
6 Application accounting status. 
7. No auto drop status. 


represented 
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est Equipment status table (EST) ordinal to which file is assigned. 


info For tape files (bit 18 of FET+10, not set): 
Bit(s) Description 
47-36 MT (display code). 
35-12 block count. 


For tape files (bit 18 of FET+10g set): 


Bit(s) Description 
47-36 UDT address assignment type. 
35-32 Data format. ; 
Value Format 

0 I 

1 SI 

2 F 

3 s 

4 L 
31-30 . Reserved. 
29-12 Random address of resource file. 
11-0 Zero. 


For terminal files: 


Bit(s) Description 
47-36 TT (display code). 
35-0 Zero. 


For mass storage files (bit 19 of FET+10g set):. 


Bit(s) Description 

47-36 Zero. As: 

35-12 Current random index. 

11-9 Zero. 

8 If set, file is an inaccessible device. 
7-0 Zero. 


For mass storage files (bit 19 of FET+10g not set): 


Bit(s) Description 

47-36 Zero. 

35-12 File length in sectors. 

11-9 Zero. 

8 If set, file is an inaccessible device. 
7-0 Zero. 
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The format B table has the following format. 


addr 


Relative address of the next entry in the local FNT. 


first file entry word 0 © 


first file entry word 1 


last file entry ‘word 0 ‘ 


last file entry word 1 - 


entire FNT. has been returned. 


Each format B file entry has the following format. 


type 
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17 14 11 


Access level (bits 17-15). 


Residence (bits 14-12). 


Bit(s) 


14-13 


12 


Description 


“File residence. 


Value Description 
0 Mass storage. 
1 - Tape. 
2 . TTY. 
3. Other. 


File’ type (bits:11-6). 


Value 
(Octal) 


ro a 
we o'r 


Description 


Rollout. . 

Library. 

Primary terminal. 
Direct access permanent 
Fast: attach. 

System. 

Local.. 

Reserved. 

Input. 

Queued file. 


‘Set if write lockout is present. 


file. 


addr is 0 if the 
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status 


fl 


| rb 


sb 
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Status of the file (bits 5-0). 


Value 


NDMP WNH eH OO 


Description 


Auto drop status. 

User file privacy status. 
Special system jobfile status. 
CB checkpoint file status. 

CK checkpoint file status. 
Special output file status. 
Application accounting status. 
No auto drop status. 


\ 


File. length in sectors (mass storage files only; zero for other files). 


Random index (mass storage files), or block count (tape files). Zero 
for other files. 


Status bits: 


Bit(s) 


11-9 
8 
7-4 


Description 


Reserved. 
If set, file is on an inaccessible device. 
Mode of use allowed for the file. 


Value : 
(Octal) Descriptiont 
0 Read. 
1 Write. 
2 Modify. 
3 Append. 
4 Execute. 
5 Read (allow modify). 
6 Read (allow append). 
7 Update. 
10 Read (allow update). 


li-17 Reserved. 


Read status (mass storage files only): 


Value Description 
~ 0 Incomplete word. 
1 EOR. 
2 EOF. 
3 EOI. 
4 BOI. 


Set if last operation was a write. 


-TRefer to PFM Macro Parameter Conventions in section 5. 
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Upon return from GETFNI, the FET is as follows: 


59 


ie} 


+11 
+12 


+14 
ia 
efnt 


cfst 


acfnt: 


' alternate checkpoint file. 


acfst 


ia is less than zero.if an error is encountered (bit. 18 of FET+10g not 
set). 


ae 


FNI word.of the checkpoint file; cfnt is zero if there is no checkpoint 
file; less than zero if more than two checkpoint files encountered’ (bit 
20 of FET+10g not set). 

FST word of the checkpoint file. 


FNT word of the alternate checkpoint file; acfnt is zero if there is no 


FST word of the alternate checkpoint file. 


The following program example illustrates format B of the GETFNI macro. (bit-21 of FET+10g 


set). This example: 
is issued if the add 


returns -three entries each time GETFNT is issued. A continuation;call 
tr field of the reply table is not zero,. indicating that there are;more 


local ey entries to be returned. 


“ qe 


BUFL '  EQU 20018 BUFFER LENGTH 
FET BSS 0 _ FET FOR FILE 
FILE1 FILEB BUF,BUFL, (FET=13) 
BUF BSS BUFL BUFFER 
FET108 VFD . 12/3,6/,18/,6/8,18/TADDR SELECT 3 ENTRIES PER REPLY, ALL FILE 
, TYPES, AND FORMAT B 
TADDR BSSZ -7 : 
- START SA1 FET10B -s . : = 7 
BX6 , x1 ; _ ENTER VALUES IN FET+108 
SA6 ‘FET+10B . , vo : 
CALL GETFNT FET . 
SYSTEM DMD, TADDR+6, TADDR DUMP REPLY TABLE : 
SYSTEM DMD, FET+12,FET DUMP FET 7s . 
SA1 | TADDR ~ : ay 
NZ X1, CALL’ ISSUE CONTINUATION CALL IF ADDR 
é ; IN FIRST WORD OF TABLE .NE. ZERG | 
ears ' 
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PRIMARY (031) 


The PRIMARY macro enables the user program to create or change a primary file (refer to 
Volume 2, Guide to System Usage, for a description of primary files). The current primary 
file (if any) is changed to a local (LOFT) file and the local mass storage file specified-in 


FET+O is made the primary file. If the specified file does not exist, an empty primary file 
is created. : 


Macro format:f 


Location Operation Variable 
PRIMARY addr 
addr Address of the FET for the new primary file. 


FILINFO (032) 


The FILINFO macro returns information about a file to a specified reply block. 


Macro format: 


Location Operation Variable 
FILINFO . addr 
addr Address of a five-word reply block. 
Before the FILINFO macro is issued, the first word of the reply block must contain the 
following: 
59 7 n 10 
con [__eealiieoneSS—C*idt Wm | 
| c Completion bit. This bit must be set by the user program before the 
macro call. : . 
len Length of parameter block (at least five words). 
TThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT : ; : 
or call common deck COMCMAC (refer to appendix F). ah q 
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The standard reply block returned has the following format. 


addr +0 
+4 
+2 
+3 
+4 
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59 47 35 29 17 


n 5 
local file name (Ifn) fien | =o 
file length in sectors ; fuer’ current random address 


Lo jo 


If the specified file is not local to your 
job, words 1 through 4 of the parameter 
block are cleared. All other fields 
_(including fields in words containing keys) 
are unchanged. : 


Completion bit.(set when operation is complete). 


The 12-bit display code of the type of device on which the file resides 
(refer to appendix E). : : , ; 


If a file is opened but not written on and it is a mass storage file that 
has not been allocated tracks on a specific allocatable device, the 
device mnemonic is binary 0. . ; 


4-26.1/4-26.2 


status 
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Status bits: 
Bit (s) 


47-27 
26-25 


Description 


Reserved. 
Tape type. 
0 Seven-track (MT). 
1 Cartridge for CTS (CT). 
2 Nine-track (NT). 
3 Cartridge for ACS (AT). 
Tape file. 
File at EOI.T 
File at EOF.7 
File at BOI.f 
Labeled tape file. 
Nine-track tape file. 
Seven-track tape file. : . 
File open; if set, indicates a CIO OPEN function 
has been issued on the file without a subsequent 
CLOSE function. 
File assigned to interactive terminal. 
File on mass storage. 
If set, file is on an inaccessible device. 
Reserved. : i 
File may be executed. 


“File in read/allow append mode (or read/allow 


modify mode) . 

File in read/allow update mode (or read/allow 
modify mode). . 

File may be altered (update, modify, or write 
mode) . ; 

File may be extended (append, modify, or write 
mode) . 

File may be shortened (write mode). 

File may be read. 


7 File position is returned for mass storage files only. EOF status is returned if the last 
operation was a read, and EOF was encountered. , 


ft File type in one of the following octal values: 


File Type Value 


Local 

Input 

Queved 
(Reserved) 
Direct access 
(Reserved) 
Primary 
Library 
Other 


NN UR WNFH O 


“I 
“I 


For mass storage files, bits 6 through 12 of the status field are set, depending on the file 
permission mode in the file’s local FNT entry. For other files, only the write lockout bit 
in the file name table is checked. If the write lockout bit is set, read-only permission is 
assumed. If the write lockout bit is not set, read and write permission is set. Bits 8 
through 12 apply only to mass storage files. If the following permission mode is set in the 
file’s local FNT entry, the indicated bits are set in the status field. 


FNT_ Mode Status Bits Set 
Read 6, 12 
Write 6, 7, 8, 9, 12 
Update 6, 9, 12 
Append 6, 8, 12 
Modify 6, 8, 9, 12 
Read/allow modify 6, 10, 11, 12 
Read/allow append 6, 11,12 
Read/allow update 6, 10, 12 
Execute 12 


For example, if read mode is set in the FNT, the user program can read (bit 6 set) or 
execute (bit 12 set) the file. 


Word 4 (addr+4) of the reply block is currently not used; however, it is reserved for future 
expansion of the FILINFO macro. 


The FILINFO macro optionally returns additional information for tape files. If the length 
(len field in addr+0) of the FILINFO reply block is greater than five, tape file information 
is returned corresponding to key values in each word after addr+4. The key words begin at 
addr+5 of the reply block and can be in any order. Keys are set by the user program in bits 
4 through 0 of each key word and are returned unaltered after the request is processed. Bit 
5 of the key word is set, and data fields are zeroed on return if the key is unknown to the 
system or is not applicable to the file type specified in addr+1. Key words with zero keys 
are ignored. 
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The following keys return the corresponding key words. 
the descriptions, the values returned are those supplied in the ASSIGN, LABEL, or REQUEST 


function, and may not equal the values actually assigned to the tape file. 


Key f 

1 

2 

4 

14g 

153 ‘ 
16g 

Field Key 
£ 1 

e 2 

ltype 2 


Returned Key Word for Tape File 


59 1 5 0 
59 17 11 8 5 0 


59 23 11 5 0 
ven wif io da 
59 47 23 11 5 0 


an 


9 36 35 11 


9 Wi 


on 


Bit (s) , Description 
11-6 Tape format: 

0 Internal (I). 

1 System internal (SI). 

2 Foreign (F). ! 

3 Stranger (S). 

4 Long block stranger (L). 

5 Long block internal (LI). 


Except where otherwise indicated in 


18 If set, error processing is inhibited (same as bit 


14 in po field). 
17-12 Label type: 


0 Unlabeled. 


1 Standard label (ANSI 1969 standard).. 


14, Nonstandard label. 


+ The symbols for each key value are defined in common deck COMSLFM. 
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| @ 
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Field Key Bit (s) Description 
den 2 11-9 Tape density: (This is the actual density, not the 


density requested on the REQUEST or LABEL command.) 


1 556 cpi (MT). | 
2 200 cpi (MT). | 
3 800 cpi (MT) or 800 cpi (NT). 
4 1600 cpi (NT). 
5 6250 cpi (NT). 
6 38000 cpi (CT or AT). 
cv 2 8-6 Conversion mode:t 
0 BCD conversion (seven-track). 
1 ASCII conversion (nine-track) . 
2 EBCDIC conversion (nine-track) . 
ven 4 59-24 Volume serial number of the currently mounted 


magnetic tape. This is the actual VSN, not the 
value from the VSN or LABEL command. 


vol 4 23-12 Logical volume number of the currently mounted 
magnetic tape. Corresponds to the ANSI standard 
file section number. 


block 14, 47-24 Maximum block size in central memory words. Always 

size 1000 octal for I and SI format tapes. For LI & 
| format tapes, the block size is 10000 octal. For F 
format tapes, the block size is calculated from the 


FC or C parameter value specified on the tape 

assignment command (refer to Volume 3, System 

Commands). For S and L format tapes, the block 

size returned is the size used on the last CIO 

Operation, as determined from the default block 

size, mlrs field in the FET, or CIO buffer size 

(refer to appendix J). The field is zero if no 

previous CIO function has been issued on the tape @ 


file. Refer to appendix J for further information. 


po 14, 23-12 Processing options. Refer to the description of 
the po field for the LABEL macro in section 4. The 
12 bits in each field have the same respective 
definitions. If po bit 18 (corresponding to po bit 
42 for the LABEL macro) is set upon return from the 
FILINFO macro, GCR hardware write error correction 
is disabled. 


If po bit 19 (corresponding to bit 43 for the LABEL 
macro) is set upon return from the FILINFO macro, 
the issuing of all error recovery messages to the 
user dayfile is enabled. 


noise 14g 11-6 Noise size in frames. 


f Conversion mode of labels (if any) and coded data (if any). This does not indicate 
whether the data on the tape is coded or binary. 
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Field ‘Key Bit (s) Description 
val 15, "35-12 Maximum size of a direct access file, based on the 


file owner’s limits from the validation file. If 
the file is not a direct access file, zero is 
returned. If the file owner has unlimited direct 
access file size validation, 77777777, is returned. 


- al 15g 11-6 Access level of the file. 
space 16g 59-12 Number of sectors remaining if the file is open for 
write. 


Number of sectors remaining in partition or in 
preallocated file if the file is not open. 
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PERMANENT FILE MANAGER ~ 5 


Permanent file manager (PFM) processes all permanent file requests. The format of the RAtl 
call to PFM is as follows: 


- 69 40 35 23.7 g o.. 
Os 7/7/77, 


R Auto recall bit. 
& code Function code. 
addr Address of the FET. 


The FET used by all PFM requests is formatted as follows. The mnemonics (CFSN, for example) . 
are defined in common deck COMSPFM. The length of the FET is defined by the symbol CFLM 


59 56 53 45 38 35 31 29 23 I7 " ) 


ee 
ae ni ce ae 
WILILLL/:/™'™!/!' JI] C/o 
CL] /| // JH] I, 7/—a 
MLL. Aa 
WlMMMMMMMqqqqqq”_ _~_ Tre 
Batlle Continuation data WHEE 

me eee rs eae 3 


| MM 


+16 
SA ll Alf 
lfn Local file name (left-justified, zero fill). 
dt Device type. 
* sa Suppress address on error messages (bit 46). 
& “up User processing bit (bit 45). 
ep Error processing bit (bit 44). 
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rt 


ip 


out 

al 

limit 
categories 


pfn 


sr 


un 


dn 


ac 


Real-time processing bit (bit 43). 
Interlock processing bit (bit 42). 

Access level processing bit (bit 39). 

FET length minus 5. 

FIRST parameter for file’s circular buffer. 
IN parameter for file’s circular buffer. 
OUT parameter for file’s circular buffer. 
Security access level. 

LIMIT parameter for file’s circular buffer. 


Security access category set (refer to SETPFAC macro). 


Permanent file name (left-justified, zero fill); if pfn is zero, lfn is 


used as the permanent file name. 

Special request subfunction. 

File category (refer to Permission Modes, File Categories). 
File access mode (refer to Permission Modes, File Categories). 
Alternate user name. 

Device number for CATLIST option (range is 1 to 77g). 
Number of PRUs (octal) desired for the file. 

Optional file password (left-justified, zero fill). 

Error message return address. | 

User control word. 

Pack name of auxiliary device. 

Number of units of multiunit device. 

New file name (refer to CHANGE macro). 

Expiration term or date for password or permit. 

Preferred residence for file (bits 59-57). 

Backup requirement for file (bits 56-54). 

Interactive subsystem asociated with file (bits 53-48). 


Alternate user CATLIST permission (bits 47-46). 


For a more detailed description of the FET, refer to the discussion of the FET in 


section 2. 
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After a request to PFM is complete, the first word of the FET contains the following 
information. 


59 17 9 O° 
L/ 
rerso (tt 
lfn Local file name. 
at Abnormal termination code. ‘ } 
c Bit 0 is set to 1 upon completion of the request. 


The FET length may be five words, if no special options are required, or up to 20g words, 
depending on the special options required. 


When a PFM macro request is processed, the parameter values specified are placed in their 
corresponding fields in the FET. 


a 
f 


On a macro call, the register X1 may be used to specify the permanent file name (pfn); the 
register X2 may be used to specify the file password (pwd); and the register X3 may be used 
to specify the alternate user name (un). After the macro is processed, the register X2 
contains the address of the FET. 


The address of the FET must be supplied in the addr parameter. The call to PFM must be made 
with the auto recall bit set (the PFM macros automatically do this). 


The system OPL common decks required for an absolute assembly of a program containing PFM 
requests are COMCPFM and COMCSYS. In order to use the mnemonics defined for PFM FET 
addresses, PFM addresses, permission modes, file categories, or error codes, the system OPL 
common deck COMSPFM is required for absolute or relocatable assemblies. Function mnemonics 
are specified in the macro descriptions. If the al parameter is specified on a SAVE, 
DEFINE, or SETPFAL macro, the system OPL common deck COMSMLS is required. 


On a secured system, your job may not access a permanent file unless it is validated for the 
access level and access category set of the file. For an alternate-user access, such an 
invalid access attempt is treated as a file-not-found error; for an access to one of your 
own files, it is treated as a security conflict (refer to section 1 for a description of 
security conflict processing). ; 


In addition, on a secured system your job may not make certain requests to change or access 
information in the Permanent File Catalog (PFC) entry. The following rules are enforced: 


e@ CHANGE, PERMIT, and SETPFAC requests are not allowed on files with an access level 
lower than that of the job. 


e CATLIST requests for permit information are not allowed on files with an access 
level higher than that of the job. Normal CATLIST requests are allowed, but the 
password expiration date, access category set, and user control word fields are 
cleared before the information is returned. If a password exists, it is returned as 
seven asterisks (****##*) , ; 
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ALTERNATE USER ACCESS PROCESSING 


Another user can access one of your permanent files only if you explicitly allow it. There 
are two ways you can allow alternate user access: 


@ By declaring the file to be a public or semiprivate file. These types of files may 
be accessed by all users in your family. The users may access only the file in the 
mode you specify, and in those modes that are subsets of the specified mode. Refer 
to PFM Macro Parameter Conventions in this section for a description of the 
hierarchy of file access modes. 


@ By permitting a specific user to access the file with a particular access mode (by 
using the PERMIT command or macro). This may be done on a private or semiprivate 
file. On a semiprivate file, the access mode specified by PERMIT overrides the 
default semiprivate access mode for the file. An expiration date may be assigned to 
each permit entry. When this date is reached, the specified user is no longer able 
to access the file. 


In addition, you may assign a password to each of your files. An alternate user must 
specify this password in order to access the file. This password may also have an 


expiration date. When this date is reached, alternate users are no longer able to access 
the file. 


ERROR PROCESSING 


The user program can issue requests to PFM and have control returned if certain error 
conditions occur. To do this, the error processing bit (ep) must be specified in FET+1. 
The error codes are returned in the abnormal termination (at) code field of FET+0 (bits 17 
through 10). 


If the user program also specifies erad in FET+12g, the error message is returned at this 
address instead of being issued to the user’s dayfile. A maximum of four central memory 
words are returned. System errors are issued to the system and error log dayfiles 
regardless of the erad specification. 


When a PFM error message is issued to the dayfile, PFM normally appends the address of the 
FET to the message. This produces a message of the form 


FILE NOT FOUND, AT 000130 


If the sa bit is specified (suppress address on error message, bit 46 of FET+1), the FET 
address is not added to the message. The result is the message 


FILE NOT FOUND 


Some PFM errors represent transient error conditions rather than true errors. When a 
transient error condition occurs, PFM retries the request until the transient error 
condition goes away. If the error goes away, the calling program never discovers that the 
error condition occurred - the PFM request simply takes more time to complete. 


However, some programs, especially those with real-time performance requirements, may be 
designed to receive an error status from PFM when a transient error condition occurs. This 
allows the program to perform useful work while waiting for the error condition to go away, 
and also allows it to abandon the request after a certain number of retries. 
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For such specialized processing of transient error conditions, there are three bits you may 
set in the FET that affect PFM error processing: . 


e Interlock processing (ip), bit 42 of FET+1._ 
e Real time (rt), bit 43 of FET+l. 
e User error processing (up), bit 45 of FET+1. 
These bits perform a similar function in that they allow the calling program to receive 


status for a set of PFM errors. But each bit affects a different set of PFM errors. You 
may specify any or all of these bits in addition to the ep bit. If one of these bits is 


“specified, and PFM returns an error code indicating a transient error condition, the calling 


program must retry the PFM request until it is successful. These bits are described below. 


ip When specified along with the ep bit, the ip bit allows the calling program to 
receive status for the following errors: INA (Interlock Not Available), PEA (PFM 
Excess Activity), PFN (Device Unavailable), and WNF (Waiting for NFL). , 


rt When specified along with the ep bit, the rt bit allows the calling program to 
receive status for the following errors: FIN (File Interlocked), PFA (PF Utility 
Active), and PSI (Stage Initiated). 


up When specified along with the ep bit, the up bit allows the calling program to 
receive status for the following errors: FIN (File Interlocked), PFA (PF Utility 
Active), PFN (Device Unavailable), PSI (Stage Initiated), PWE (Waiting for Alternate 
Storage Exec), and WNF (Waiting for NFL). In addition, if the calling job is a 
subsystem, the up bit allows the calling program to receive status for the following 
errors: INA (Interlock Not Available) and PEA (PFM Excess Activity). 


The following error codes are returned in the abnormal termination code field, described 
earlier in this chapter. It is recommended that the error code mnemonics defined in common 
deck COMSPFM be used in testing these error conditions. The mnemonics are qualified by 
symbol ERRMSG. For example, to set the B/ register to the value of the FBS mnemonic, use 
the following instruction: 


SB7 /ERRMSG/FBS 


The error codes listed next are given in 


octal. 
Error 
Code Mnemonic Description 
1 FBS , The specified direct access file is attached with conflicting 
mode (file busy). 
2 ‘FNF One of the following: 
e@ The specified permanent file was not found. 
@ The specified user name was not found. 
e You are not authorized to access the specified file. 
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Error 
Code 


10 


12 


12 
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Mnemonic 


EFL 


FAP 


IFt 


IUA 


IDR 


Description 


@ The specified local file was not found (SAVE, 
REPLACE, or APPEND) . 


@ An indirect access file request was issued for a 
direct access file. 


@ A direct access file request was issued for an 
indirect access file. 


The file specified on a SAVE, REPLACE, or APPEND macro 
contains no data. ; 


The file to be saved is not on mass storage. The first track 
of the file is not recognizable. 


The user program has already saved or defined a file with the 
name specified. 


The user program attempted to define a file that is not a 
local file. 


File name contains illegal characters. 
One of the following: 
@ You are not validated to create direct access files. 


@ You are not validated to create indirect access 
files. 


@ You are not validated to access auxiliary devices. 


e@ The user program made a CATLIST request for permanent 
information on a file that has a higher access level 
than that of the job. 


The device type (r parameter in macro calls) specified on a 
request for an auxiliary device cannot be recognized or does 
not exist in the system. 


If the removable auxiliary device specified by the pn 
parameter is not the same type as the system default, the r 


‘parameter must be included. If not, this error code is 


returned. 


The local file specified for a SAVE, REPLACE, or APPEND 
request exceeds the length allowed, or the direct access file 
specified for an ATTACH in write, modify, update, or append 
mode exceeds the direct access file length limit for which 


.the user is validated. 


Error 
Code 


13 


14 


15 


16 


17 


20 


21. 


22 


23 


24 


25 


26 


Mnemonic 


ILR 


PFN 


PFA 


COF 


SPN 


IOE 


PRL 


PLE 


Description 


One of the following: 
@ Illegal permit mode or catalog type specified. 


@ CATLIST request has permit specified without a file 
name. 


@ DEFINE, CHANGE, or SAVE attempted with alternate user 
name in FET. 


Access to the permanent file device requested is not 
possible. (This error code is returned only if the ip bit 
and/or the up bit is specified in the FET.) 


The device on which the file resides may not contain direct 
access files because: 


e The device is not specified as a direct access device 
in the catalog descriptor table. 


@ The device is not specified as ON and initialized in 
the catalog descriptor table. 


e The device is a dedicated indirect access permanent 
file device. 


Because a permanent file utility is currently active or a 
permanent file device is inaccessible, the operation is not 
attempted. The user program should retry the operation. 
(This error code is returned only if the rt bit and/or the up 
bit is specified in the FET.) 


An error occurred in a read operation during a file transfer. 


The number of files in your catalog exceeds the limit (refer 
to the LIMITS command in Volume 3, System Commands) . 


The cumulative size of the indirect access files in your 
catalog exceeds the limit (refer to the LIMITS command in 
Volume 3, System Commands) . 


The number of PRUs specified via the s parameter on the 
DEFINE macro is not available. 


A request is attempted on a local file that is currently 
active. This error can occur, for example, if the user 
program creates two FETs for the same file and issues a 
second request before the first is complete. 


The job’s local file limit has been exceeded by an attempt to 
GET or ATTACH the file. 


The job’s mass storage PRU limit is exceeded during 
preparation of a local copy of an indirect access file. 


Too many explicit permits have been created for the specified 
file. 
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Error 
Code 


27 


30 
31 
32 


33 
34 


35 


36 
37° 


40 
41 
42 
43 


“44 


45-47 
50 
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Mnemonic 


PAE 


RSE 
TKL 
FLE 


RIN 
DAF 


RPE 


ABT 


MSE 


EDA 
EPT 
EDP 
FLC 


NEM 


FSE 


Description 


One of the following: 
e An illegal function code was specified. 


e The FET address specified was not within the user 
program’s field length. 


e The error message return address specified was not 
within the user program’s field length. 


e@ PFM was not called with auto recall specified. 
The resource executive detected a fatal error. 
No available space remains on the device. 


The length of a file does not equal the catalog length. The. 
action taken depends on the type of request issued. 


Request Action 

GET A local file is created with length being the 
actual length retrieved. 

SAVE _ If file length is longer than TRT 
specification, file is truncated. 

REPLACE Same as for SAVE. 


PERMIT random address error. 


The system sector data for the file does not match the 
catalog data. fase 


The same file is found twice during a catalog search. This 
error can occur for APPEND or REPLACE requests after a file 
is found and. purged and the catalog search is continued. 


Error flag detected at PFM control point. . 


An error is encountered in reading or writing a portion of 
the permanent file catalog or-permit information. A write 
error is encountered during the device to device transfer of 
an indirect access file. 


Error in data for file. 
Error in. permit entries for file. 
Combination of errors 40 and 41. 


An error in the EOI position of the file was detected by 
recovery routines. 


PFM detected a fatal RESEX error. PFM does not issue a 
message since RESEX has issued an appropriate message. If 
the error processing (ep) bit is set and the erad field of 
FET+12,, contains a valid address, the message RESEX issues is 
returned to that address. : 


Reserved. 


Verification of the file structure or owner identification 
failed. 


GR a 


53-70 


71 


72 


73 


74 


75 
76 


77 
100 
101 
102 
103 


104 


105 


Mnemonic 


SSE 


BCS 


PSI 


PWE 


FIN 


SGD 


IPA 


PVE 


FND 


INA 


AIO 


Description 
Error in system sector of indirect access file. 


An invalid catalog or permit sector was detected while 
attempting to access the file. 


Reserved. 


The file does not reside on disk. An unrecoverable error was 
detected when attempting to stage the file to disk from 
alternate storage. 


The file does not reside on disk. It is currently being 
staged from alternate storage to disk. (This error code is 
returned only if the rt bit and/or the up bit is specified in 
the FET.) : 


The file must be staged from alternate storage to disk, but 
the subsystem is not currently available to perform the stage 
operation. (This error code is returned only if the up bit 
is specified in the FET.) 


The file is currently not available for write, modify, 
update, or append modes of access because a system utility 
has the file attached in utility mode. (This error code is 
returned only if the rt bit and/or the up bit is specified in 
the FET.) 


Reserved. 
Reserved. 


The local file specified for a SAVE, REPLACE, or APPEND 
request was an execute-only file. 


The file does not reside on disk and must be staged from 
alternate storage to disk, but your site has disabled staging. 


The device number, track, and sector specified as the 
permanent file catalog (PFC) address are invalid. 


The creation date and time, user index, or alternate storage 
address do not agree with the current PFC contents. 


Access to a file that does not reside on disk is not permitted 
with the current function. 


A software interlock is currently not available. (This error 
code is returned if the ip bit is specified in the FET. If 
the calling job is a subsystem, it is also returned if the up 
bit is specified in the FET.) 


The disk space for a file cannot be released when the 


alternate storage image is labeled obsolete or the alternate 
storage address is not specified in the PFC. 
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Icu 


PEA 


DEM 


JCA 


Description 


The disk space for a file cannot be released when a permanent 
error status is set for the alternate storage file image. 


File name table (FNT) space is currently not available for a 
request that has both ep and up processing options set. 


Verification of the PFC prohibits the setting of a new 
alternate storage address when the alternate storage address 
is defined and not labeled obsolete. Also, an existing valid 
disk address cannot be replaced in the PFC entry. 


The PFM activity count is currently at its limit. (This 
error code is returned if the ip bit is specified in the FET. 
If the calling job is a subsystem, it is also returned if the 
up bit is specified in the FET.) 


You are not authorized to set a password or permit expiration 
date. 


The expiration date or term you specified exceeds the maximum 
expiration term allowed by your site. 


Your job is not validated for the access level or access 
category set for the specified file. 


The specified access level is not valid for the calling job. 


You are not authorized to perform the operation for one of 
the following reasons: 


@ The local file has a higher access level than the 
permanent file it replaces or to which it is being 
appended. 


e The local file has a lower access level than the 
job on a DEFINE request. 


e The specified permanent file has an access level 
lower than that of the job on a CHANGE, PERMIT, or 
SETPFAC request. 


The specified access category set is not valid for the 
calling job. 


The local file access level is incompatible with the user’s 
master device access level limits. 


The specified access level is lower than the current file 
access level, and you are not authorized to lower file access 
levels. 


No temporary device could be found with the correct access 
level. 


Error 
Code Mnemonic Description 

123 LNF The specified access level on a SAVE request is lower than 
the local file access level. 

124 TPE The system encountered a temporary error that prevents it 
from moving your file in from alternate storage. Wait and 
try the request again. 

125 WNF Your job is delayed while waiting for NFL. (This error code 
is returned only if the ip bit and/or the up bit is specified 
in the FET.) 

126 -- Reserved. 

127 -- Reserved. 

130 ECD The CATLIST continuation data specified in the FET was 


incorrect. 


PFM MACRO PARAMETER CONVENTIONS 


Several methods are available for specifying the m, ct, 8s, br, pr, and ac parameters in PFM 
macros. You can specify either an alphabetical key or an address that contains an integer 
value that corresponds to a key. If an address is specified, the value must be right - 
justified and zero-filled in a 60-bit word. (These parameters are stored in the FET in 
right-justified, zero-fill format, except for the lfn, pfn, pwd, and nfn parameters which 
are stored in left-justified, zero-fill format.) 


The values can be established with the mnemonics in the following list. 


co 


For a CHANGE request, 40B must be added to the octal 
value in the following list. The macro does this 
automatically if you specify an alphabetic key instead 
of a value for the parameter. 


The user program must call common deck COMSPFM to use these mnemonics (relocatable or 
absolute assembly). The valid mnemonics (if any), keys, and values for the m, ct, ss, br, 
pr, and ac macro parameters are listed. 
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Parameter Mnemonic 
m 


PTWR 


PTRD 


‘ PTAP 


PTEX 


PTMD 


’ 


Value 


(Octa1)7 


Description 
File or user permission mode: 


Allows the user program to write, 
read, append, execute, modify, and/or 
purge the file. New information can 
be added within the existing 
boundaries of the file, and the file 
can be extended or shortened. This 
mode can be specified for direct or 
indirect access files. 


Allows the user program to read and/or 
execute the file. This mode can be 
specified for direct or indirect 
access files. 


Allows the user program to append 
information to the end of the file 
(EOI). This mode can be specified for 
direct or indirect access files. 


Allows the user program to execute the 
file. This mode can be specified for 
direct or indirect access files. 


Removes permission previously granted 
via PERMIT macros. This mode can be 
specified for direct or indirect 
access files. 


Allows the user program to modify, 
append, read, and/or execute a direct 
access file. Adding new information 
within the existing boundaries of the 
file is legal, and the file size may 
be extended, but the file may not be 
shortened. For an indirect access 
file, this mode allows you to perform 
all the functions of the R (read) mode 
and the A (append) mode. 


{ For a CHANGE request, 40B must be added to this value. The macro does this automatically 


if you specify an alphabetic key (instead of a value) for this parameter. 
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Value 
Parameter Mnemonic Key (Octa1)t Description 


PTRM pe iT 6 Allows the user program to read and/or 
execute a direct access file with the 
implication that another user may 
currently be accessing the same file 
in M (modify), A (append), or U 

. (update) mode. For indirect access 
files, this mode is the same as R 
(read) mode. 


PTRA ra tt 7 Allows the user program to read and/or 
execute a direct access file with the 
implication that another user may 
currently be accessing the same file 
in A (append) mode. For indirect 
access files, this mode is the same as 
R (read) mode. 


PTUP U 10 Allows the user program to modify, 
read, and/or execute a direct access 
file. Information may be added within 
the existing boundaries of the file, 
but the file size must be maintained. 
For indirect access files, this mode 
is the same as R (read) mode. 


PTRU RU 11 Allows the user program to read and/or 
execute a direct access file with the 
implication that another user may 
currently be accessing the same file 
in U (update) mode. For indirect 
access files, this mode is the same as 
R (read) mode. 


+ For a CHANGE request, 40B must be added to’ this value. The macro does this automatically 
if you specify an alphabetic key (instead of a value) for this parameter. 


Tt Special care should be taken when using modes RM, RA, or RU. Programs using access 
techniques that do not expect concurrent updating of a file may get erroneous results if 
these modes are used. In particular, CRM AAM (refer to the CYBER Record Manager Advanced 
Access Methods Reference Manual) is not designed to deal with concurrent reading and 
updating of a file by multiple users. 


Therefore, if a program using CRM AAM attempts to access a file attached in RM, RA, or RU 
mode while a second program using CRM AAM is accessing the file in M, A, or U mode, one or 
both of the jobs may be aborted and an error message may be issued stating that the file 
was ruined. In fact, the file may still be intact, but CRM cannot guarantee this and so 
will not allow the access. 
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Parameter 


ct 


Mnemonic 


FCPR 


FCSP 


Value 


(Octal)? 


Description 
& 
File category: 


Private. Private files are available 
for access only by the originator or 
those to whom the originator has 
explicitly granted permission (refer 
to the PERMIT macro). 


For each permitted user, the system 
records the number of accesses and the 
date and time of the last access. 

This information may be displayed 
using CATLIST (LO=FP). 


The system also records the total 
number of accesses (by any user), the 
date and time of the last access (by 
any user), and the date and time of 
the last modification (by any user). 
This information may be displayed 
using CATLIST (LO=F). 


Semiprivate. Semiprivate files are 
available for access by all users who 
know the file name, user name, and 
file password. The file owner 
specifies the default permitted mode 
of access for all users. The file 
owner may also specify, via the PERMIT 
macro or command, different 
permissions for different users. 


For each user who accessed the file, 
the system records the user name, the 
number of accesses, and the date and 
time of the last access. This 
information may be displayed using 
CATLIST (LO=FP). 


The system also records the total 
number of accesses (by any user), the 
date and time of the last access (by 
any user), and the date and time of 
the last modification (by any user). 
This information may be displayed 
using CATLIST (LO=F) . 


Tt For a CHANGE request, 40B must be added to this value. The macro does this automatically 


if you specify an alphabetic key (instead of a value) for this parameter. 
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Value 
Parameter Mnemonic Key (Octa1)7 Description 
FCPB PU 2 Public. Public files are available for 


access by all users who know the file 
name, user name, and file password. 
The file owner specifies the default 
permitted mode of access for all 
users. The file owner may also 
specify, via the PERMIT macro or 
command, different permissions for 
different users. 


For each explicitly permitted user, 
the system records the number of 
accesses and the date and time of the 
last access. This information may be 
displayed using CATLIST (LO=FP). For 
accesses by users who are not 
explicitly permitted, this information 
is not recorded. 


The system also records the total 
number of accesses (by any user), the 
date and time of the last access (by 
any user), and the date and time of 
the last modification (by any user). 
This information may be displayed 
using CATLIST (LO=F). 


} For a CHANGE request, 40B must be added to this value. The macro does this automatically 
if you specify an alphabetic key (instead of a value) for this parameter. 
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Parameter Mnemonic 


8s 


brit 


BRAL 


BRMD 


prt. 


RSDS 


RSTP 


ac 


ACNO 


ACYS 


FORT 


Value 


(Octal) 


_ accessed. 


Baperiotisn 
Subsystem indicator: 
Null subsystem. 
BASIC subsystem. 
FORTRAN 5 subsystem. 
FORTRAN Extended 4 subsystem. 
Execute subsystem. 


Batch subsystem. 


Backup requirement: 


Backup is not required on a dump tape. 
Backup is required on a dump tape. 


Backup is required on a dump tape only 
if the file is not resident on 
alternate storage. 


Preferred residence: 


The file will be locked to disk. 
(Special validation is required for 
this option.) 


The file should reside on disk at all 
times. 


The file should reside on MSE or 
optical disk storage when. it is not 
being accessed. 


No preferred residence for the file. 


The file should reside on tape 
alternate storage when it is not being 


Alternate CATLIST permission: 


Alternate users may not obtain 
information about the file by using 
CATLIST (default value). 


Alternate users may obtain information 
about the file by using CATLIST. 


j If this parameter is omitted or a value of 0 is specified, PFM uses the installation 


default value. 
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AUXILIARY DEVICE REQUEST 


Unless you explicitly declare otherwise, all of your permanent files reside on family 


devices. 


As stated in Volume 3, System Commands, you may wish to supplement the mass 


storage provided by your family devices by retaining your files on auxiliary devices. (Not 
all users may be validated to use auxiliary devices.) There are four parameters (pn, r, un, 
and pwd) that uniquely identify file pfn on an auxiliary device. 


The pn parameter specifies the one- to seven-character system-defined pack name of 
the auxiliary device. The device can be either public or private, as defined by the 
installation. 


The r parameter specifies the type of auxiliary device on which the file resides or 
is to reside. An auxiliary device is any supported device that an installation 
defines as an auxiliary; it need not be a removable device. 


r may be DBn, DCn, DDn, DE, DFn, DGn, DHn, DIn, DJn, DKn, DLn, DMn, DN, DP, DQn, DV, 
DW, EAn, EBn, ECn, EDn, EB, or EF, as described for Device Types in appendix E. 


If you need two or more removable auxiliary devices, or one removable auxiliary 
device and one or more magnetic tapes, at any one time during your job, a RESOURC 
command must be included (refer to Volume 3, System Commands) . 


An installation can provide additional continuous storage on a DB, DC, DD, DF, DG, 
DH, DI, DJ, DK, DL, DM, DQ, EA, EB, EC, or ED type device by combining several 
physical units into one logical unit. A device so defined is known as a multiunit 
device. To specify such a device, the r parameter must include the number of units. 
For example, if four 844-21 units have been combined as one multiunit device, the r 
parameter must be DI4. If it is not, the job step aborts. 


However, if r is DB, DC, DD, DF, DG, DH, DI, DJ, DK, DL, DM, DQ, EA, EB, EC, or ED 
but n is omitted, the unit count is assumed to be 1. 


The r parameter is required only if the desired device has a device type different 
from that of the installation-defined default device type, and the installation has 
defined the desired device as removable. However, you can be assured of always 
accessing the proper device by specifying this parameter. If an incorrect value is 
specified for r, PFM error message l1lg (IDR) is issued. For all PFM macros, if pn 
is specified but the device is not available, the job is aborted. By setting the 
error processing bit (FET+1, bit 44) you can bypass the abort and direct the system 
to make the specified device available. If both the error processing bit and the 
user processing bit (FET+1, bit 45) are set, control is returned to the user program 
when the device is unavailable and error code 14g (PFN) is set in FET+0. 


The un parameter specifies the one- to seven-character optional user name. If the 
device is public, files are accessed in the same manner as specified for family 
devices; that is, the un parameter must be included only if you wish to access files 
that another user has explicitly or implicitly permitted you to use. If the device 
is private, there is only one owner. All other users who have the proper validation 
can access files on the device, but the system prevents them from creating files on 
that device. 


The pwd parameter specifies the one- to seven-character password associated with the 
file. As with files on family devices, the pwd parameter must be included only if 
the originator requires that a password be specified. 
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SAVE (001, CCSV) 


The SAVE macro enables the user program to retain a copy of a temporary mass storage file as 
an indirect access permanent file. The original file is rewound when the copy is complete. 


Macro format: 


Location Operation Variable 
SAVE addr, pfn,pwd,ucw,ct,m,pn,r,fo,s8s,br,pr,xt,al,ac 
addr Address of the FET; the local file name must be set in FET+0. 
pfn Address containing the name of the file; name the file is. given in the 


permanent file catalog. 
pwd Address containing the password to be placed with the file in the 
permanent file catalog. * 


ucw Address containing user control word to be placed with the file in the 
permanent file catalog. If this word exists in the catalog, it is 
returned to FET+13, when the file is accessed (default=0) . 


et ‘File category: 
ct Description 
P Private file (default value). 
s Semiprivate. 
PU Public file. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 


m File mode. This parameter defines the type of access alternate users 
may have for semiprivate or public files. 


m Description 

Ww Read, write, append, purge, and execute (default value). 
R Read and execute. 

A Append. 

E Execute. 

M +Read, append, and execute. : 
N None. 

RM Same as R for indirect access files. . 
RA Same as R for indirect access files. | 
U Same as R for indirect access files. 
RU Same as R for indirect access files. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 
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pn 


fo 


858 


br 


pr 


Address containing one- to seven-character pack name of the auxiliary 
device on which the file is to be saved. 


Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command 
or macro. This causes the file to be saved on your family device. 


Type of auxiliary device on which the file is to be saved (refer to the 
DEFINE macro) . 


Family option: 


IP 


The pack name specified by a PACKNAM macro or pn parameter 
is ignored. PFM accesses your family. 


Subsystem indicator. This indicator causes automatic subsystem 
selection when the file is retrieved using the OLD macro or command. 


EXEC 
BATCH 


Description 


Null subsystem. 

BASIC subsystem. 

FORTRAN 5 subsystem. 

FORTRAN Extended 4 subsystem. 
Execute subsystem. 

Batch subsystem. 


Refer to PFM Macro Parameter Conventions in this section for further 


information. 


Backup requirement. Specifies whether the file is to be backed up on a 
dump tape when the site dumps permanent files. 


br 


N 


Description 


The file must be backed up on the dump tape. 


Backup file on dump tape only if a copy does not exist on 
alternate storage. 


The file is not to be backed up on the dump tape. 


Refer to PFM Macro Parameter Conventions in this section for further 


information. 


Preferred residence. Specifies whether you prefer the file to reside on 
disk or on alternate storage. 


pr 


rom 


Description 


The file should reside on MSE or optical disk storage when 
it is not being accessed. 

No preferred residence for the file. 

The file should reside on disk at all times. 

The file will be locked to disk. (Special validation is 
required for this option.) 

The file should reside on tape alternate storage when it is 
not being accessed. 


Refer to PFM Macro Parameter Conventions in this section for further 


information. 
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xt 


al 


ac_ 


Example 1: 


Expiration term or date for password. xt is the address of a word. 
containing either the packed expiration date (format: yymmdd, where yy 
is the year minus 1970), or the expiration term, the number of days. 
(<7777g) to be added to the current date to determine the expiration 
date. A value of 7777, indicates a nonexpiring password. If this 
parameter is not specified when a password is established, the system 
creates a nonexpiring password. You must be validated to assign a 
permanent file expiration date in order to use this parameter. 


Security access level of the file. This may be either the name of the 
access level or the address of a location containing the numerical value 
of the access level. System OPL common.deck COMCVLC: can be used to 
convert access level: names to numerical values and vice versa. System 
OPL common deck COMSMLS is required if you specify this parameter. 
Using this parameter sets the access level bit (bit 39 of FET+1). 


If an access level is specified in the al field of the FET rather than 


. aS a macro parameter, your program.must also set the access level bit . 


(bit 39 of FET+1). 


On a secured system, any access level specified must be valid for your 
job and for the local and permanent file devices involved. é 


Alternate CATLIST permission. Specifies whether alternate users may 
obtain information about the file using CATLIST. 


Description 


Permission denied. 
Permission granted. 


Sz 8 
fo} 


Refer to PFM Macro Parameter Conventions in this section for further 
information. : 


t 


This example saves local file FILE in the permanent file system as a public file name 
DATA with read permission. The file will be backed up on a dump tape’when the site 
dumps permanent files. : : : 


FILE 
PF 
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SAVE FILE,PF,,,PU,R,,,,,Y 


FILEB BUF,BUFL,(FET=16) _ 
VFD 42 /OLDATA,18 /0 


Example 2: 


This example performs the same function as example l. 


XTEXT COMSPFM 


SA1 PF 
SAVE FILE,X1,,,FCAT,FMOD,,,,,BACK 


FCAT © CON FCPB 

FMOD CON PTRD 

BACK CON 2. 

FILE FILEB BUF,BUFL, ( FET=16) 

PF VFD 42 /OLDATA,18 /0 
Example 3: 


In this example, local file TAPEl is saved in the permanent file. system as a private 
re file name PTAPE] with null permission. The subsystem indicator is set:to the batch 


subsystem. 
SAVE F,PF,,,P,N,,,,BATCH 
F BSS OO 
TAPE1 FILEB BUF,BUFL, (FET=16) 
PF VFD 42 /OLPTAPE1,18 /0 
5-18 
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GET (002, CCGT) =e Ree 


The GET macro enables the user program to obtain a temporary copy of an indirect access 
permanent file. If a local file by the same name already exists, it is returned as if the: 
UNLOAD macro had been issued even if the GET is unsuccessful.“ The new file.is. set to 
rewound status. No interlock is provided.to ‘prevent other users from obtaining copies of 
the same file simultaneously. 


The local file created by a GET macro call may be an execute-only file, depending on the 
access mode permitted to the user name associated with the user program. PFM returns the 
access mode of the file. in the mode field (FET+10g, bits 0 through 5) if the FET is long 


,enough; the user program can examine this field to determine the access mode. If the FET is 


long enough, the user control word (ucw) is. returned to FET+13g, and the- -subsystem is 
returned to FET+17g, bits 59-57. Refer to PFM Macro Parameter Conventions in this section 


for a list of access modes and subsystems. 
If the access level bit (bit 39 of FET+1) tee set, the access neuer of ne file is returned 
to bits 38 through 36 of FET+4. : 


Macro format: 


+ 


Location Operation Variable 


GET. addr,pfn,un,pwd,pn,r,fo- 
addr Address of the FET; the local file name must be set in FET+0. 
: - Card x a 
pfn ; Address containing the name of the file; name the file is given in the 


permanent file catalog. 


un Address containing the number of the alternate user whose catalog is to™ 
be searched for the file specified; if this parameter.is specified, the 
permission mode is that which the user has been permitted for private 
files or that specified in the catalog for semiprivate and public files. 

pwd ; Address containing the password of the file; required if un#0 and thé 
file requires a password. 


pn : Address containing one- to seven-character pack name of the auxiliary 
device from which the file is to be retrieved. . 


Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set .the PACKNAM command or 
macro. This causes Foe eeaueee to be. processed on your: fens y aewrces 


r Type of auxiliary device on which the and irects access pevianent file 
resides (refer to the DEFINE MACEG):s : 


fo Family option: 


IP The pack name specified by a PACKNAM macro or pn’ paraneter 
is ignored. PFM accesses your family. 
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PURGE (003, CCPG) 


The PURGE macro enables the user program to remove the specified. file from the: permanent 
file system. To purge a file in an alternate user’s catalog, you must have write permission 
for the file or the file must be a semiprivate or public file with write mode. 


Macro format: 


Location Operation Variable 
PURGE addr ,un, pwd, pn,r,fo 
addr. Address of the FET; the local file name must be set in FET+0. If 


FET+10g contains a permanent file name, that file name is used for the 
PURGE operation. 


un Address containing the user name of the alternate catalog for the file 
to be purged. 


pwd. Address containing the password of ene file; required if un#0 and the.. 
file requires a password. 


ph .- Address containing one- to seven-character pack name of the auxiliary 
device on which the file resides. 


‘Entering the display.code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command 
or macro. ‘This causes the request to be processed on your family device. 


r Type of auxiliary device identified by the pn parameter (refer to the 
DEF INE macro). 
fo Family option: 
IP The pack name specified by a PACKNAM macro or pn parameter 


is ignored. PFM accesses your family. 


An example of the use of this macro is: 


PURGE F 


F FILEB BUF ,BUFL 


These instructions purge permanent file F. 
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CATLIST (004, CCCT) 


The CATLIST macro can be used for the following applications: 


@ .To determine the information about one or more of your own permanent files. 


@ To determine the information about one or more files belonging to a specified 
alternate user. You will only be allowed to see information about those files you 


can access and the owner has specified you to receive (via the AC = 


Y parameter) . 


@ To determine the alternate user information for a specified file that an alternate 
user can access or has accessed in your catalog (permit data). 


The first type of application is the return of the permanent file catalog entries of all 


your files. 
one file will be returned. 


If a permanent file name is specified in FET+CFPN, the catalog entry of that 


The format of the permanent file catalog (PFC) entry is as follows: 


47 44 41 36 


59 S56 53 


file name 


access count 


alt opt disk address 


reserved 


‘file name 
user index 
file length 
' track 
sector 
random index 
creation date 


and time 


access count 
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os 23 17 11 0 


nC 
EC 77/7, a oa 
Pa] rode [ef[eo] an | __lastaccess dato andime | 
PeTe] ss [efZZZZA____witycontrl date nme | 

file password 
a 7/7, 
[_sesoner fa 7 soracscatgoies id 
5 7/7 ee 


password exp date 


Permanent file name. 
User index of file creator. 
Length in PRUs of the file. 


Beginning track of file. 


FCEN, FCUI 
FCLF, FCBT, FCBS 

FCRI, FCCD 

FCAC, FCMD 

FCCT, FCAM, FCEC, FCEF, FCEO, FCAD 
FCOA, FCKD 

FCRS, FCBR, FCFS, FCUD, FCAP 

FCPW 

FCAF, FCAT, FCAA, FCAV 

FCAL, FCFC 

FCCN 

FCP1 

FCP2 

FCTF, FCTS, FCTV _ 

FCUC 

FCIW 


Beginning sector of file (420xx for a direct access file). 


Random disk address of permit sector. 


‘ 


Date and time (yymmddhhamss in octal) when this file was 


first entered on the permanent file pe eas The year (yy) is 


the calendar year minus 1970. 


Count of accesses to file. 


data modification 


date and time 


ct 


mode 


ef 


ec 


last access 
date and time 


alt opt disk 
address 


control modification 
date and time 


ac 


utility control 
date and time 


Date and time (yymmddhhmmss in octal) when the data in this 
file was last modified. The year (yy) is the calendar year 
minus 1970. For direct access files this field is updated 
when the file is attached in a modifiable mode, whether or 
not the file is actually modified. 


File category (refer to PFM Macro Parameter Conventions for 
further information) . 


File mode (refer to PFM Macro Parameter Conventions for 
further information) . 


Error flag: 


0 No error. 
1 EOI changed by recovery. 


Error code: 


No error. 
Error in data for file. 
Error in permit entries for file. 
Error in data and permit entries for file. 
File length error. 
7 Reserved. 


1 PWN) OO 


Device number (0 through 778); each device within a family of 
permanent file devices is identified by a device number. 


Date and time (yymmddhhmmss in octal) when this file was last 
accessed. The year (yy) is the calendar year minus 1970. 


Alternate optical disk address; optical alternate storage 
address with VSN and version specified in the asa field. 


Date and time (yymmddhhmmss in octal) when the control 
information (catalog entry and permit record data) for this 
file was last updated. This corresponds to the last time a 
CHANGE or PERMIT command or macro was processed for the file. 
The year (yy) is the calendar year minus 1970. 


Preferred residence for file (refer. to PFM Macro Parameter 
Conventions in this section for further information) . 


Backup requirement for file (refer to PFM Macro Parameter 
Conventions in this section for further information) . 


Subsystem code for this file (refer to PFM Macro Parameter 
Conventions in this section for further information) . 


Alternate CATLIST permission for this file (refer to PFM 
Macro Parameter Conventions in this section for further 
information) . 


Date and time (yymmddhhmmss in octal) used to determine this 
file’s candidacy for being dumped by permanent file 
utilities. The year (yy) is the calendar year minus 1970. 
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file password 


password exp date 


aflags 


alt 


asa 


al 


access 
categories 


charge number 
project number 


tflags 


fsn 


packed vsn 


user control word 
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Optional password. On a secured system the password is 
returned as seven asterisks (*******) if a password is 


“defined and the file has an access level higher than that of 


the job. 


The date on which the password expires (yymmdd in octal). 
The year (yy) is the calendar year minus 1970. 


Cartridge alternate storage flags; used with the asa field 
and meaningful only if a copy of the file resides on MSE or 
an optical disk alternate storage device (as indicated by the 
alt field); refer to the NOS 2 Analysis Handbook for a 
complete description of this field. 


Cartridge alternate storage type: 


0 No alternate storage copy of the file exists. 

2 An alternate storage copy of the file resides on 
MSE. 

3 An alternate storage copy of the file resides on 


optical disk. 


Cartridge alternate storage address; meaningful only if an 
MSE or optical disk alternate storage copy of the file exists 
(as indicated by the alt field); if asa is 0, the file does 
not reside on MSE or optical disk alternate storage; refer to 


‘the NOS 2 Analysis Handbook for a complete description of 


this field. 


File’s security access level. 


Each of bits 31 through 0, if set, indicates that the 


corresponding category is in the security access category set 
for the file. The system OPL common deck COMCVLC can be used 


. to convert an access category value to an access category 


name. 
Charge number to which the file will be billed. 
Project number to which the file will be billed. 


Tape alternate storage flags; used with the fsn and packed 
vsn fields and meaningful only if a copy of the file resides 
on tape alternate storage, as indicated by the packed vsn 
field. Refer to the NOS 2 Analysis Handbook for a complete 
deseription of this field. 


File sequence number of this file on the archive tape 
identified by the packed vsn. ' 


Packed vsn of the archive tape containing a copy of this 
file. Refer to the NOS 2 Analysis Handbook for a complete 
description of this field. 


User control information (FET+138). 


The second type of application is a CATLIST of another user’s files. The system returns the 
permanent file catalog entries of all the user’s files you are permitted to access and that 
are listable by another user. (A file is listable by way of CATLIST only if the owner has 
specified an alternate CATLIST permission [AC=Y].) If a permanent file name is specified in 
FET+CFPN, the catalog entry of the specified file will be returned (provided the file is 
listable by CATLIST and that you are permitted to access it). The following fields are 
cleared before the catalog entries are returned: user index, access level, access category 
set, password, and password expiration date. 


The third type of application is a CATLIST of PERMIT data. All alternate user access 
entries (permit entries) for a specified file are returned. The format of an alternate user 
access entry is illustrated. 


59 41 35 aa 0 


username Alternate user name. 


expiration The date on which the permit expires [yymmdd in octal; the year (yy) is. 


date the calendar year minus 1970]. 
aua Number of accesses the alternate user has made to the file. 
ed Bit 41; if set, indicates that an expiration date is present in bits 


17-0 of the first word of the entry. 


m Permission mode (bit 40 set if this was an accounting permit and was 
not created by a PERMIT command or macro; bit 40 clear indicates an 
explicit permit set by PERMIT command or macro; bits 39 through 36 are 
same as mode described in first type of request). 


ad The last date the alternate user accessed the file [yymmdd in octal; 
the year (yy) is the calendar year minus 1970]. 


at The time of day the alternate user last accessed the file (hhmmss in 
octal). 
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Macro format: t 


Location Operation Variable 
' CATLIST addr,pfn,un,m,pn,r,fo,dn 
addr Address of the FET for the CATLIST function. 
pfn Address containing the file name; if this parameter is omitted, CATLIST 


information for all files in your permanent aca catalog (or in the 
catalog specified by un) is returned. 


un Address containing the name of the alternate user catalog to be searched 
for the catalog information. If un is omitted, your own catalog is 
searched. 

m If this parameter is the letter M, alternate user access information for 


file pfn is returned. If this parameter is specified, the pfn is 
required and un is ignored. 


pn Address containing one- to seven-character pack name of the auxiliary 
device that contains catalog information for all users with’ information 
on that device. 


Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command 
or macro. This causes the request to be processed on your family 
device. 


r Type of auxiliary device identified by the pn parameter (refer to the 
DEFINE macro) . 


fo Family option: 


IP The pack name specified by a PACKNAM macro or pn parameter 
is ignored. PFM accesses your family: 


dan. Request CATLIST of files on device number dn (FET+118, bits 17 through 
12). Any value may be specified. 


If the status returned in FET+0 (addr parameter of the CATLIST macro), bits 9 through 0, is 
0033 (EOF encountered), the user program should reissue the CATLIST macro after the buffer 
of entries has been processed (refer to example 1). The user program should continue this 
until a status of 1033 (EOI encountered) is returned. CATLIST uses the current random index 
field (FET+6, bits 59 through 30) to keep track of its position for continued calls. If the 
user program changes this field, the results of a CATLIST request may be undefined. 


Information is placed in the buffer starting at IN until (IN=LIMIT-1), at which time buffer 


full (0033) status is set in FET+0. PFM does not process the buffer circularly; therefore, 
the user program must reset (IN=OUT=FIRST) before reissuing the CATLIST macro. 


+ This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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The following examples assume that PSSTEXT is specified at assembly. 
Example 1: 


The following program creates a binary file named F with permanent file catalog entries 
for all files in your catalog. (The system OPL must be attached to assemble this 


program.) 
IDENT CAT, FWA 
ABS 
ENTRY START 
SYSCOM Bl 
OPL XTEXT COMSPFM 
ORG 112B 
FWA BSS fe) : ' 
BUFL EQU 1001B 
F FILEB BUFF, BUFL 
G FILEB BUFG, BUFL, FET=10D 
START SB1 1 
STA1 CATLIST G ‘ 
STA2 READW G, WBUF, NWCE TRANSFER CATALOG ENTRY 
NG X1,STA3 IF BUFFER EMPTY 
WRITEW F, WBUF, NWCE 
EQ STA2 TRANSFER NEXT CATALOG ENTRY @ 
STA3 S$X1 X1+B1 
NG X1,STA4 IF EOI (CATLIST COMPLETE) 
SA1 G+1 RESET FET POINTERS 
SX7 X1 
SA7 Al+B1 SET IN=FIRST 
SA7 A7+B1 SET OUT=FIRST 
EQ STA1 GET NEXT BUFFER LOAD 
STA4 WRITER F 
| ENDRUN @ 
BUFF BSS BUFL 
BUFG BSS BUFL 
WBUF BSS NWCE 
| OPL XTEXT COMCCIO 
} OPL XTEXT COMCPFM 
OPL XTEXT COMCRDW 
| OPL XTEXT COMCSYS 
| OPL XTEXT COMCWTW 
| END 
| 
| 
5-26 60459690 D & 


Example 2: 
The following example returns all access information for file DATAO013. 


CATLIST F,PF,,M 


F FILEB BUF, BUFL, (FET=10D) 


PF VFD 42/0LDATA013,18/0 
Example 3: 


This example returns a list of all files that you can access by way of CATLIST in the 
catalog of user USERABC. [A file is listable by way of CATLIST only if the owner has | 
specified an alternate CATLIST permission (AC=Y) .] 


CATLIST F,, AUN 


F FILEB BUF, BUFL, (FET=10D) 
AUN VFD 42/0LUSERABC, 18/0 


PERMIT (005, CCPM) 


The PERMIT macro enables your program to explicitly permit another user to access a private 


file in your permanent file catalog. You may also use PERMIT on a semiprivate or public 

file in your catalog to set a special permission value for a specific user. This special 
permission overrides the default permission value established by SAVE, DEFINE, or CHANGE. 
If you wish to remove permission previously granted, you should select the negate (null) 

mode. : : 


Macro format: 


Location Qperation Variable 
PERMIT addr,pfn,un,m,pn,r,fo, ,xt 
addr Address of the FET; the local file name must be set in FET+0. 
pfn Address containing the name of the file; name of the file is given in 


the permanent file catalog. 


un Address containing the user name of the user being granted permission. 
m Mode of permission being granted; if no mode is specified, W (write) is 
assumed. 
m Description 
WwW Read, write, modify, append, update, purge, and execute 
(default value) . 

R Read and execute. 

A Append. 

E Execute. 5 

N None (negate previous permissions) . 

M Modify, append, update, read, and/or execute. 
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pn 


fo 


xt 


F 
PF 
AUN 


This allows user 
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m Description 

RM Read and/or execute, allow simultaneous access in 
modify, append, or update mode. 

RA Read and/or execute, allow simultaneous access in append 
mode. 

U Update. 

RU Read and/or execute, allow simultaneous access in update 
mode. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 


Address containing one- to seven-character pack name of the auxiliary 
device on which the specified file resides. 


Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command 


er macro. This causes the request to be processed on your family 
device. 


Type of auxiliary device identified by the pn parameter (refer to the 
DEFINE macro) . 


Family option: 


IP The pack name specified by a PACKNAM macro or pn parameter 
is ignored. PFM accesses your family. 


Expiration term or date for permit. xt is the address of a word 
containing either the packed expiration date (format: yymmdd, where yy 


is the year minus 1970), or the expiration term, the number of days 


(<7777g) to be added to the current date to determine the expiration 
date. A value of 7777, indicates a nonexpiring password. If this 
parameter is not specified, the system sets a site-defined default permit 
expiration date. You must be authorized to assign a permanent file 
expiration date in order to use this parameter; also, your site may 
choose to limit the maximum expiration term you may specify. 


An example of the use of this macro is: 


PERMIT F,PF,AUN,A 


FILEB BUF,BUFL, (FET=10D) 
VFD 42/0LDATA012,18/0 
VFD 42/0LUSERABC, 18/0 


USERABC to have append permission to file DATAO012. 
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REPLACE (006,CCRP) az 


The REPLACE macro enables the user program to place a copy of the specified local mass 


storage file in the permanent file system as an indirect access file. If an indirect a 
permanent file with the specified name already exists in the catalog, that file will be 
replaced by the new file placed in the catalog as the same type of file. If the file d 
not exist in the catalog, a new indirect access permanent file is created as if a SAVE 
request had been made. Permission information and alternate user access data. are not l 
when the file is replaced. 


Macro format: ae fe: 


Location Operation Variable 
REPLACE addr, pfn,un, pwd,ucw, pn,r,fo,m 
addr _ Address of the FET; local file name must be set in FET+0. 
pfn .. - Address containing the name of the permanent file: to be replaced in 


permanent file catalog. 


un Address containing the name of the alternate user’s catalog where t 
file resides. 


pwd Address containing the password of the file being paplaced (this ma 
required on an alternate user access). 


ucw Address containing user control word to place with the file; bit 59 
FET+13g must be set to retain the word with the file in the catalog 


pn Address containing one- to seven-character pack name of the auxilia 
device on which the file is to be placed. 


Entering the display code character zero (left-justified, binary ze 


ecess 
oes 


ost 


the 


he 
y be 


of 


Ty 


ro 


fill) in this field overrides the pack name set by the PACKNAM command 


or macro. This causes the file to be replaced on your family devic 
r , Type of auxiliary device identified by the pn parameter (refer to t 
DEFINE macro). 
fo Family option: 
IP The pack name.specified by a PACKNAM macro or pn parame 
is ignored. PFM accesses your family. 
m. oe Specifies the file access mode if the file does not eprendy. ‘exist. 
-is omitted, READ is assumed. 
If m is: . Other users can: 
R or READ Retrieve a copy of the file. This copy can be 


RU or READUP'  - or executed. 
RA. or READUP — 

RM or READMD 

U or UPDATE 
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E or EXECUTE Retrieve a copy of the file. This copy can only be 


executed. 
A or APPEND Append data to the file with the APPEND command. 
M or MODIFY Retrieve a copy of the file or append data to the. file. 


The user can enter GET, OLD, NEW and APPEND commands, but 


not a REPLACE command for the file. 


W or WRITE Retrieve a copy of the file, append data to it, replace 


it, or purge it. 


N or NULL No access is allowed. 


APPEND (007, CCAP) 


The APPEND macro enables a user program to add the contents of the specified local mass 
storage files to the end of the specified indirect access permanent file. The logical 
structure of the two files is retained; that is, EORs and EOFs are appended as well as data. 
If the working file is appended to a file in an alternate user's catalog, a password must be 
supplied if one is required. 


Macro format: 


Location 


un 


- pwd 


pn 


fo 


Operation Variable 
APPEND addr, pfn, un, pwd,pn,r,fo 


Address of the FET; name of the local file to be appended must be set in 
FET+0. 


Address containing the name of the permanent file to which information is 


to be appended. 


Address containing the name of the alternate user whose catalog contains 
the permanent file. 


Address containing the password of the file to which information is to be 


appended. This must be specified if un#0 and the file requires a 
password. 


Address containing one- to seven~character pack name of the auxiliary 
device on which the specified permanent file resides. 


— 


Entering the display code character zero (left-justified, binary zero 


fill) in this field overrides the pack name set by the PACKNAM command or 


macro. This causes the request to be processed on your family device. 


Type of auxiliary device identified by the pn: parameter (refer to the 
DEFINE macro). 


Family option: 


+ 


IP The pack name specified by a PACKNAM macro or pn parameter is 


ignored. PFM accesses your family. 
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An example of the use of this macro is:t 


APPEND F 
F FILEB BUF, BUFL, (PFN=DATA) 


The structure of file DATA after the APPEND macro is issued is as follows. 


OLD FILE DATA RESULTING FILE (DATA) 


DATA 


OLD FILE F 


{ The permanent file name can be set by FET creation macros as well as being set in the 
permanent file macros. 
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DEFINE (010, CCDF) 


The DEFINE macro enables the user program to create a direct access permanent file. If the 
user program attempts to create a direct access file with the same name as a local file, the 
local file must reside on a legal permanent file device for your user name. If a local file 
with the same name does not exist, an empty file is created on an appropriate device. 


Macro format: 


Location 


addr 


pfn 


pwd 


ucw 


rt 


ct 


Qperation Variable 
DEFINE addr, pfn,pwd,ucw,r,ct,m,pn,s,fo,br,pr, ,xt,al,ac 


Address of the FET. FET+0 must contain the local file name of the file 
to be made a direct access file (name used when the job accesses the 
file). 


Address containing the name of the permanent file entered in the 
catalog. If pfn=0, the contents of FET+0 is used for the permanent file 
name. 


If pwd is specified, the password is retained with the file; all 
alternate users must supply this password when attaching file. 


Address containing user control information, bit 59 of FET+138 must be 
set to retain this data. If this parameter is supplied, this data is 
retained in the catalog entry for the file and returned to FET+138 when 
the file is attached. 


Specifies the type of family or auxiliary device on which the permanent 
file resides or is to reside; r can be DBn, DCn, DDn, DE, DFn, DGn, DHn, 
DIn, Ddn, DKn, Din, DMn, DN, DQn, DP, DW, DV, EAn, EBn, ECn, EDn, EE, or 
EF, as described for Device Types in appendix EB. If r is not one of -- 
these values, the value specified represents the address that contains 
the display code equivalent, left-justified. If the device is a 
multiunit type device (DBn, DCn, DDn, DFn, DGn, DHn, DIn, Ddn, Dkn, DLn, 
DMn, DQn, EAn, EBn, EBCn, or EDn), n is the number of physical units the 
installation combined into one logical unit; n is converted from display 
code to octal and placed in FET+14,, bits 11 through 0. Also, if r is 
DB, DC, DD, DF, DG, DH, DI, DJ, DK, DL, DM, DQ, EA, EB, EC, or ED but n 
is omitted, the unit count is assumed to be 1. If r is not specified, 
the system default device type (or the device type specified in the last 
PACKNAM macro or command) is used. 


File category: 


et Description 

P Private file (default value). 
Ss Semiprivate. 

PU Public file. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 


ft If the file later resides on MSE and then is staged back to disk, it may not reside on the 
device type specified by the r parameter. 
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pn 


fo 


br 
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File mode. This parameter defines the type of access alternate users 
may have for semiprivate or public files. 


m Description 

W Read, write, modify, append, update, purge, and execute 
(default value) . 

R Read and execute. 

A Append. 

E Execute. 

N None. 

M Modify, append, update, read, and/or execute. 

RM Read and/or execute, allow simultaneous access in modify, 

: append, or update mode. 

RA Read and/or execute, allow simultaneous access in append 

, mode. 

U Update. 

RU Read and/or execute, allow simultaneous access in update 
mode. ! 


Refer to PFM Macro Parameter Conventions in this section for further 
information. a 
Address containing the one- to seven-character pack name of the 


auxiliary device on which the direct access file is to reside. 


Entering the display code character zero (left-justified, binary zero 
£i11) in this field overrides the pack name set by the PACKNAM command 
or macro. This causes the file to be defined on your family device. 


Address containing the number of PRUs desired for the direct access 
file. The number of PRUs is in octal, right-justified. DEFINE places 
this value in FET+1lg bits 23 through 0 (CFOU). 

Family option: 


IP The pack name specified by a PACKNAM macro or pn parameter 
is ignored. PFM accesses your family. 


Backup requirement. Specifies whether the file is to be backed up ona 
dump tape when the site dumps permanent files. 


br Description ° - 

Y The file must be backed up on the dump tape. 

MD . Backup file on dump tape only if it does not reside on 
alternate storage. 

N The file is not to be backed up on the dump tape. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. ; 


pr Preferred residence. Specifies whether you prefer the file to reside on 
disk or on alternate storage. 


pr Description 
M The file should reside on MSE or optical disk storage when 


it is not being accessed. 

No preferred residence for the file. 

The file should reside on disk at all times. 

The file will be locked to disk. (Special validation is 

required for this option.) 

T The file should reside on tape alternate storage when it is 
not being accessed. 


ros 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 


xt Expiration term or date for password. xt is the address of a word 
containing either the packed expiration date (format: yymmdd, where yy 
is the year minus 1970), or the expiration term, the number of days 
(<7777g) to be added to the current date to determine the expiration 
date. A value of 7777, indicates a nonexpiring password. If this 
parameter is not specified when a password is established, the system 
creates a nonexpiring password. You must be validated to assign a 
permanent file expiration date in order to use this parameter; also, 
your site may choose to limit the maximum expiration term you may 
specify. 


al Security access level of the file. This may be either the name of the 
access level or the address of a location containing the numerical value 
of the access level. System OPL common deck COMCVLC can be used to 
convert access level names to numerical values and vice versa. System 
OPL common deck COMSMLS is required if you specify this parameter. 
Using this parameter sets the access level bit (bit 39 of FET+1). 


If an access level is specified in the al field of the FET rather than 
as a macro parameter, your program must also set the access level bit 
(bit 39 of FET+1). 


On a secured system, any access level specified must be valid for your 
job and for the local and permanent file devices involved. 


ac Alternate CATLIST permission. Specifies whether alternate users may 
obtain information about the file using CATLIST. 


ac Description 
N Permission denied. 
Y Permission granted. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 
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If 1fn does not exist at the time the DEFINE request is issued, the device on which pfn 
resides depends on the r and s parameters. 


rc Ss ; Residency 
Specified Not specified The file resides on the device of type r with the 


most space available. vgs 


' 


Specified Specified - The file resides on the device of type r with the 
most space available, provided that device has as 
Sets many PRUs available as specified by the s parameter. 


Not specified Specified . The file resides on the device with the most space 
available, provided that ‘device has as many PRUs 
available as specified by the s parameter. 


Not specified = Not specified The file resides on the device with the most space 
available. : 


Example 1: 


This defines file F as a read-only public file on a DI device. The name of the entry in 


the permanent file catalog is DATA.. (It is assumed that the file did not exist before 
the DEFINE request was issued.) ; 


DEFINE F,PF,,,DI,PU,R — 


F FILEB BUF,BUFL, (FET=9) 
PF VFO 42 /OLDATA, 18/0 


Example 2: 


The same: operation could be accomplished by the following sequence of instructions. 


SA1 PF 
DEF INE F,X1,,,RES,FCAT,R 


F. FILEB BUF,BUFL, (FET=9) i 
PF ~ VED 42 /OLDATA,18 /0 
RES VED 12 /0LD1, 48/0 
FCAT CON = FC PU nt 
ORL - -XTEXT  COMSPFM 


Example 3: 


The following sequence defines file DATA. The file will not be backed up on the archive 
tape if it is residing on MSE, and its preferred" residence is MSE. 


DEFINE P,PF,,,,,,,,,MD,M 


F FILEB BUF,BUFL,(FET=16D) 
PF VFD 42 /OLDATA,18/0 , 
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ATTACH (011, CCAT) 


The ATTACH macro enables your program to attach the specified direct access file to your job. 


A read/write interlock is provided to ensure that only one user at a time accesses the file 
in write mode. Several users may access the file in read mode simultaneously. You should 
return the file as soon as possible to enable other users to access the file. If a local 
file by the same name already exists, it is returned as if the UNLOAD macro had been issued 
even if the ATTACH is unsuccessful. 


If the FET is long enough, the user control word for the file is returned to FET+139, 


If the access level bit (bit 39 of FET+1) is set, the access level of the file is returned to 
bits 38 through 36 of FET+4, 


Macro format: 


Location Operation Variable 
ATTACH addr,pfn,un,pwd,m,pn,r,fo,sr,rt 

addr : Address of the FET. FET+0 must contain the local file name of the file 
while attached to the job. 

pfn Address containing the name of the file in the permanent file catalog. 
If pfn is 0, the contents of FET+0 is used for the permanent file name. 

un Address containing name of the alternate user catalog on which the file 
resides. 

pwd Address containing file password; entered only if un is not 0 and the 


file requires a password. 


m Mode of access desired: 
Loa Description 
W Read, write, modify, append, update, purge, and/or execute 


(default value). 

Read and/or execute. 

Append, update, read, and/or execute. 

Execute. 

None. 

Modify, append, update, read, and/or execute. 

Read and/or execute, allow simultaneous access in modify, 
append, or update mode. 

Read and/or execute, allow simultaneous access in append mode. 
Update, read, and/or execute. 

Read and/or execute, allow simultaneous access in update mode. 


ail em a 


~ 
q 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 


pn Address containing one- to seven-character pack name of the auxiliary 
device on which the specified permanent file resides (refer to the DEFINE 
macro). 


Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set by the PACKNAM command or 
macro. This causes the file to be processed on your family device. 
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c Type of auxiliary device identified by the pn parameter (refer to. the - 
DEFINE macro). 


fo . Family option: 
IP. The pack name apenitied by a PACKNAM macro or pn PAT eRerEE. is 
ignored. PFM accesses your Fautlys 
sr Special request subfunction: 
‘st . Description 
FAT The file being attached must be a fast attach permanent file. 
IEt Ignore error idle status. , 
NF The file being attached may not be a fast attach permanent 
file. 
rt Real-time mode. If this parameter is specified (any. value may be used), 


the job step is not delayed for any of the following conditions: 


e The file must be staged to disk from MSE or tape alternate 
Bhorases 


e Nn permanent file utility is currently acetve; Poane rae the 
ATTACH processing. 


e The mass storage device on which the file resides is inaccessible. 


If none of these conditions exist, the rt parameter has no meaning. If 
one of these conditions exists and the rt parameter is not specified, the 
job step is delayed until the operation is complete. If one of these 
conditions exists and the rt parameter is specified, the file is not 
attached. Instead, the operation to ensure that the file resides on disk 
is initiated. To complete the attach operation, another ATTACH macro 
with or without the rt-parameter should be issued and the FET status 
checked to ensure that the file was accessed. The function of the rt 
parameter is also accomplished by setting the rt bit in the FET. 


‘lf a file is busy at the time the user program issues an ATTACH macro for the file, the 


system aborts the request. The user program can bypass the abort by specifying error 
processing (the ep bit, bit 44 of FET+1). If ep is set and the file is busy, the system 
returns control to the user program. The user program may then suspend the job by issuing a 


-ROLLOUT macro. Normally, when a program issues a ROLLOUT macro to roll out a job subject to 


time/event dependencies, the program must include an address specifying the time period 
and/or event. However, when file busy status is returned, PFM sets up a time/event entry for 
the user program, specifying a rollout time period of 360g seconds. If the file becomes 
available before the time period expires, the job is rolled in at that time. The user 
program should then.attempt the ATTACH once again. 


Refer to the ATTACH command in Volume 3, System Commands, for a description of the current 
access modes that result when you attempt to attach an active file. 


tThe calling program must have an SSJ= entry point. 
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CHANGE (012, CCCG) 


‘The CHANGE macro allows you to alter the attributes of one of your direct or indirect access 
permanent files without having to recreate the file. The pn and r parameters cannot be used 
to specify a new auxiliary device. They are used only to specify the auxiliary device on 
which ofn resides. Although all attributes that may be specified by parameters on the macro 
may also be specified using the appropriate fields in the FET, the file category, file access 
mode, file subsystem, and user control word must each have the top bit of the field set if 
they are to be specified in the FET for this request. 


Macro format: 


Location Operation Variable 
CHANGE addr ,ofn,nfn,pwd,ucw,ct ,m,pn,r,fo,sr,ss,br,pr,xt,ac 
addr Address of the FET; the local file name must be set in FET+0. 
ofn Address containing the old permanent file name. If ofn is not specified, 


the contents of FET+0O is used instead. 


nfn _ Address containing the new permanent file name. If nfn is not specified, 
no name change takes place. 


pwd Address containing new password; replaces the old password or adds a new 
password if there was none before. If pwd is omitted, the contents of 
FET+18g bits 59 through 18 are used as the new password. If you do not 
wish to change the current password, either FET+12g must be set to 
42/77777777777777B,18/0 or the contents of location pwd must be set to 
42/777777777777778,18/0. 


ucw Address of word containing user control information; bit 59 of the word 
must be set if this information is to be used. If ucw is not specified, 
the contents of FET+13g are used instead; bit 59 of FET+13g must be set 
in that case. 


ct File category: 

ct Value (Octal) Description 
P 40 Private file. 
Ss 41 Semiprivate. 
PU 42 Public file. 

Refer to PFM Macro Parameter Conventions in this section for further 

information. 
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pn 


fo 


sr 
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File mode. This parameter defines the type of access alternate users 
may have for semiprivate or public files. 


m Value (Octal) Description 

WwW 40 Read, write, modify, append, update, purge, and 
execute (default value). 

R 41 Read and execute. 

A 42 Append. 

E 43 Execute. 

N 44 None. 5 

M 45 Modify, append, update, read, and/or execute. 

RM 46 Read and/or execute, allow simultaneous access 

; in modify, append, or update mode. 

RA 47 Read and/or execute, allow simultaneous access 
in append mode. : 

U 50 Update. 

RU 51 Read and/or execute, allow simultaneous access 


in update mode. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 


Address containing the one- to seven-character pack name of the 
auxiliary device on which the file resides. 


Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the pack name set the the PACKNAM command 
er macro. This causes the request to be processed on your family 
device. 


Address containing the type of auxiliary device identified by the pn 
parameter (refer to the DEFINE macro). 


Family option: 


Ip The pack name specified by a PACKNAM macro or pn parameter 
is ignored. PFM accesses your family. 


Special request subfunction (only one may be specified): 


_CE Clear file error code in the catalog entry (refer to the 
CATLIST macro for a description of the catalog entry). 
cP Reset the charge number and project number for the file to 


your job’s current charge and project number. 


Subsystem indicator. This indicator causes automatic subsystem 
selection when the file is retrieved using the OLD macro or command. 


58 Description 


NULL Null system. 

BASIC BASIC subsystem. 

FORT FORTRAN 5 subsystem. 

FINTS FORTRAN Extended 4 subsystem. 
EXEC Execute subsystem. 

BATCH Batch subsystem. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. ; 


br 


pr 


xt 


ac 


% 


Backup requirement. Specifies whether the file is to be backed up ona 
dump tape when the site dumps permanent files. 


br Description 
Y The file must be backed up on the dump tape. 
MD Back up file on dump tape only if it does not reside on 


alternate storage. 
N The file is not to be backed up on the dump tape. 


If the backup requirement is not to be changed, the br field of the FET 
must be 0. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 


Preferred residence. Specifies whether you prefer the file to reside on 
disk or on alternate storage. 


pr Description 


M The file should reside on MSE or optical disk storage when 
it is not being accessed. . 

No preferred residence for the file. 

The file should reside on disk at all times. 

The file will be locked to disk (special validation is 

required for this option) . 

T The file should reside on tape alternate storage when it is 
not being accessed. 


rom 


If the preferred residence is not to be changed, the pr field of the FET 
must be 0. 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 


Expiration term or date for password. xt is the address of a word 
containing either the packed expiration date (format: yymmdd, where yy 
is the year minus 1970), or the expiration term, the number of days 
(<7777g) to be added to the current date to determine the expiration 
date. A value of 7777, indicates a nonexpiring password. If this 
parameter is not specified when a password is established, the system 
creates a nonexpiring password. You must be validated to assign a 
permanent file expiration date in order to use this parameter; also, 
your site may choose to limit the maximum expiration term you may 
specify. This parameter may not be specified without also specifying 
the pwd parameter unless the file already has a password. 


Alternate CATLIST permission. Specifies whether alternate users may 
obtain information about the file using CATLIST. 


ac Description 


Permission denied. 
Permission granted. 


Km 


Refer to PFM Macro Parameter Conventions in this section for further 
information. 
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Example 1: 
t This changes file DATA on auxiliary device PACK] to FILE with read-only access. 


. CHANGE F,PF,NF,PW,,,R,PKN 


F FILEB BUF,BUFL,(FET=14D) 
PF ‘VED § 42/0LDATA,18/0 
NF. VED - 42/0LFILE,18/0 

PKN VFO 42 /OLPACK1,18/0 

PW VFD 42 /-0,18/0 


@ Example 2: 


This éiuapie changes the backup requirement of file DATA to MD Gacein file on dump tape 
only if it does not reside on MSE) and the preferred residence to M (MSE) | 


CHANGE DATA,,,PWresr57772M0,M - “ 


DATA FILEB BUF,BUFL, ( FET=16D) e 
® Pw VFD = 42/-0,18/0 
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OLD (021, CCOD) — _- 


The OLD macro enables the user program to. obtain a temporary copy of an indirect access 
permanent file and make it the primary file. If a local file’ by the same name already 
exists, it is returned as if the UNLOAD macro had been issued ‘even if the OLD is 
unsuccessful. If a primary file exists (with a different local file name) before the OLD 
request, it is converted to a local (LOFT) file. The new primary file is set to rewound 


status. No interlock is provided to prevent other users from obtaining copies of the same 
file simultaneously. 


The OLD macro also sets the subsystem index associated :with ‘the file. 


The local file created by an OLD macro call may be an execute-only file, depending on the: 
access mode permitted to the user name associated with the user program. PFM returns the 
access mode of the file in the mode field (FET+10g, bits 0 through 5) if the FET is long 
enough; the user program can examine this field to determine the access mode. If the FET is 
- long enough, the user control word (ucw) is returned to FET+13g, and the subsystem is 


returned to FET+17g, bits 59-57. Refer to PFM Macro Parameter Conventions in this section 
for a list of access modes and subsystems. 


If the access level bit (bit 39 of FET+1) is set, the access level. of the file is returned to 
bits 38 through 36 of FET+4. 


Macro format: 


Location Operation Variable 
OLD addr, pfn,un,pwd,pn,r,fo 
addr ‘Address of the FET;: the local file name must be set in FET+0. 
pfn ' + Address containing the name of the file; name the file is given in the °- 


permanent file catalog. 


un . Address containing the name of the alternate user whose catalog is to-be 
searched for the file specified; if this parameter-is specified, the 
permission mode is that which the user has been permitted for private 
files or that specified in the catalog for semiprivate and public files. 


pwd Address containing the password of the file; required if un#0 and the 
file requires a password. 


pn Address containing one- to seven-character pack name of the auxiliary 
device from which the file is to be retrieved. 


Entering the display code character zero (left-justified, binary zero 
fill) in this field overrides the packname set by the PACKNAM command or 
macro. This causes the file to be saved on the family device of the user 
name associated with the user program. 


xr Type of auxiliary device on which the indirect access permanent file 
resides (refer to the DEFINE macro). 


fo Family option: 


IP The pack name specified by a PACKNAM macro or pn parameter is 
ignored. PFM accesses your family. 
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SETPFAC (022,CCAC) | 


The SETPFAC macro enables the user program -to ee the security access category set of a 
permanent file.. 


If this function is to be performed on a direct access file, the file must not be attached to 
any job. 


Macro format: 


Location Operation , Variable 
SETPFAC addr,pfn,cat,pn,r 
addr Address of the FET for the file. 
pfn Address containing the name (left-justified, binary zero fill) of the 


permanent file whose access category set is to be changed. If this 
parameter is omitted, the contents of FET+0 are used for the permanent. 
file name. 


cat Address containing the new security access category set for the file. 
Each of bits 0 through 31 that is set in this word sets the corresponding 
security access category. The access categories specified must be valid 
for your job (refer to Security Access Categories in section 1). The 
System OPL common deck COMCVLC can be used to convert access category 
names to numerical values and vice versa. 


pn Address containing the one- to séven-character pack name of the auxiliary 
device on which the file resides. 


rT 


r Type of auxiliary device identified by the pn parameter (refer to the 
DEFINE macro). 
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SETPFAL (023,CCAL) 


The SETPFAL macro enables the user program to change the security access level of a permanent 
file. This macro requires the system OPL common deck COMSMLS. 


If this function is to be performed on a direct access file, the file must not be attached to 


any job. 


Macro format: 


Location 
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addr 


pfn- 


al 


pn 


Operation Variable 


SETPFAL addr, pfn,al,pn,r 


Address of the FET for the file. 


Address containing the name (left- 


justified, binary zero fill) of the 


permanent file whose access level is to be changed. If this parameter is 
omitted, the contents of FET+0 are used for the permanent file name. 


The security access level to be assigned to the file. al can be either 
the name of the security access level, or the address of a word 
containing the numerical value of a security access level, right- 


justified with binary zero fill. 


To convert an access level name to a 


numerical value (or vice versa), use system OPL common deck COMCVLC. The 
access level specified must be valid for your job (refer to Security 
Access Levels in section 1) and valid for the device on which the file 


' resides. 


Address containing the one- to seven-character pack name of the auxiliary 


device on which the file resides. 


Type of auxiliary device identified by the pn parameter (refer to the 


DEFINE macro). 
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The following examples show two different ways to specify an access level using the SETPFAL 
macro. 


Example 1: 


In this example, the file’s access level is specified in the macro call and therefore 
must be an access level name. 


| e 
| OPL XTEXT COMSMLS 
| OPL XTEXT COMCPFM 
TEST ’ FILEB BUF,101B,(FET=13D) 


& BUF BSS 101B 


SETPFAL TEST,,LVL3 


Example 2: 


@ : In this example, the file’s access level is specified in a separate word and therefore 
must be a numerical value. 


OPL XTEXT COMSMLS 


OPL XTEXT COMCPFM 
TEST FILEB  BUF,1018,(FET=13D) 
BUF BSS 101B 

LEVEL CON 3 


SETPFAL TEST,,LEVEL 
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-CONTROL POINT MANAGER 6 


Control point manager (CPM) enables. your program to alter or interrogate parameters 2 your 
job’s control point area. 


Unless otherwise noted, all.errors encountered by CPM cause the job step to be aborted; no 
user error processing is available. 


The format of the call to CPM is: 


© | — 
a 59 4035 23.17 0 


Rat Ce 77 ee 


R Auto recall bit. 
code . CPM function code. 
a —_ ff : Subfunction code for fisekiens 003 and 017. 
@ param . Parameter for the function. 


Common decks required for absolute assemblies by the functions processed,by CPM are COMCCPM 
and COMCSYS. For relocatable assemblies, these decks are satisfied by deraute from the 
library SYSLIB. 


SETPR (001) 


The SETPR macro decreases the CPU priority of a job. A user job-cannot increase its 
& priority. ‘ 
Upon job initiation, a job is assigned the maximum priority allowed for its service class. 
(The installation defines these priority. values.) If a job’s CPU priority is lower than 
that of other jobs, the job is assigned control of the CPU only when ‘jobs of a higher 
priority do not need it. 


Macro format: f 


Location Operation Variable 
SETPR n 
n CPU priority; (1<n<70g), Re - of 8 . : 
@ {This macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 


or call common deck COMCCMD or COMCMAC (refer to appendix F). 
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MODE (002) 


The MODE macro defines the error conditions that cause the system to exit from normal 
processing and, on CYBER 180-class models, changes the instruction stack purging status of 
the central processor (refer to the exchange package description in appendix E). 


When the error specified in a MODE macro occurs, the system sets the appropriate error flag 
and exits from normal processing to perform any error processing required. If an error 
occurs for which the user program did not select the exit mode processing, the system 
ignores the error and continues normal processing. 


Macro format :T 


Location Operation Variable 
MODE m,n,p 
n - CPU program error exit mode. 
n This parameter is included for compatibility with earlier versions of 


NOS. The value supplied is ignored. 


P Instruction stack purging (CYBER 180-class models only): 
0 Normal instruction stack purging. 
| Extended instruction stack purging. 

The processor will exit when 
this condition occurs If m has one of these octal values 
Address out of range (automatically 1, 3, 5, 7, 11, 13, 15, 17TT 
selected for model 176) 
Operand out of range (overflow only 2, 3, 6, 7, 12, 13, 16, 17 
on model 176) 
Indefinite operand 4, 5, 6, 7, 14, 15, 16, 17 
Underflow (model 176 only) ; 10, 11, 12, 13, 14, 15, 16, 17 


The maximum value and default on all models except model 176 is 7, indicating that the 
processor exits on all conditions. The maximum value on model 176 is 17g, indicating that 
‘the processor exits on all conditions. The default value on model 176 is 7, indicating that 
the processor exits on all conditions except underflow. 


TThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCCMD or COMCMAC (refer to appendix F). . 

Tton a model 176, the address out of range error will always cause a processor exit. 
Therefore, any attempt to disable this type of exit (by specifying a value not included in 
-this set) on a model 176 will cause an informative message to be issued to the dayfile. 
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Instruction stack purging on CYBER 180-class models can be made normal or extended by 
supplying an appropriate value for p. The initial status of stack purging is site- 
selectable. When stack purging is normal, the processor purges the instruction stack after 
executing an exchange jump, return jump, unconditional branch, or extended memory read 
instruction. When stack purging is extended, the processor also purges the instruction 
stack after central memory store and conditional branch instructions. Under normal 
circumstances, the CYBER 180-class models processor fetches the contents of the branch 
destination address prior to executing the branch; this could cause Eeogname that do code 
modification to fail unless stack Purging is extended. 


An attempt to change the stack purging status on any machine other than CYBER (180- class 
models BLOTES the program. 


Null or omitted parameters remain unchanged if fewer than three values are supplied on the 
macro call. Changes made to exit mode or stack purging status remain in effect for 
subsequent job steps unless explicitly changed by a MODE or MACHINE command or a MODE macro. 


Examples: 


Setting m to 6 on all models other than a model 176 selects error exiting on operand out 
of range and indefinite operand. On a model 176, address out of range cannot be 
deselected; it is automatically set by the system. Setting m to 6 or 7 on a model 176 
would yield the same results. i 


Setting m to 13g on a model 176 selects underflow and error exiting on operand out of 
range. Setting m to 12g would also accomplish this. 


SETASL (003) 


The SETASL macro allows the user program to specify the account block SRU limit for a job. 
The account block limit is the maximum number of SRUs that can be accumulated by a job. 


If s is greater than or equal to 655400g, or greater than your validated maximum, the 
account block SRU limit is set to the maximum for which you are validated (infinite if 
unlimited validation) . 


For interactive jobs, this function defines the number of SRUs allowed for a job before 
entry of another CHARGE command is required. For batch or interactive jobs, s represents 
the maximum SRU accumulation between two CHARGE commands or between one CHARGE command and 
the end of the job. If s is less than your current job step SRU limit, both your account 
block and job step SRU limit are set to s. 


Macro format: | 


Location Qperation Variable 
SETASL 8 
8 Account block SRU limit. 


} This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT -or call common deck COMCCMD (refer to appendix F). 
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SETJSL (003) 


The SETJSL macro allows the user program to specify the job step SRU limit for each step of 
a job, including the current job step. The job step limit is the maximum number of SRUs 
that can be accumulated by a single job step. The job step limit must not exceed the 
account block limit (refer to SETASL macro) . 


Each user name and each charge/project number is validated for a maximum SRU limit. If s is 
| greater than or equal to 655400g, or greater than your validation maximum, the job step SRU 
limit is set to the maximum for which you are validated (infinite if unlimited validation) . 
Also, if s is greater than your current account block SRU limit, both your job step and 
account block limits are set to 8s. 


Macro format: t 


Location Qperation Variable 
SETJSL 8 
8 dob step SRU limit. 


SETTL (003) 


The SETTL macro changes the user program’s CPU job step time limit for each job step, 
including the current job step. The CPU job step time limit is the amount of time (in 
seconds) that a job step is allowed to use the CPU. 


Each user is validated for a maximum time limit (refer to the LIMITS command in Volume 3, 
System Commands). If t is greater than or equal to 77770g, or greater than your validation 
maximum, the time limit is set to the maximum for which you are validated (infinite if 
unlimited validation) . 


Macro format:t 


Location Operation Variable 
SETTL t 
t Job step time limit (1<t<777770g) . 


{This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). 
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EREXIT (004)t 


NOS allows a user program to specify an error processing routine address. When an error 
occurs during program execution, the system causes the routine at that address to begin 
executing. If an additional error occurs while the error processing routine is executing, 
the job step aborts. ‘ ‘ 


. 


An error will occur if an EREXIT macro is 
issued while REPRIEVE processing is in : 
effect (REPRIEVE processing is described in 
section 10 of this manual). If an EREXIT 
macro is issued while DISTC processing is in 
effect, EREXIT processing will be 
established and DISTC processing will. no 

. longer be in effect (DISTC processing is 
described in section 11 of this manual). 


t 


Macro format: 


Location | Operation Variable. 
EREXIT addr - 
addr Address for error exit return. 


As an example, a common procedure is for.the program’s preset routines to set: the error exit 
processing. 3 


Routine to ERR SA1 BO READ ERROR RETURN INFO 
complete _ . 
processing . 
when an error « 
is encountered - "ENDRUN - | TERMINATE PROGRAM 
PRS SUBR PROGRAM PRESET ROUTINE 


EREXIT ERR SET ERROR EXIT ADDRESS 


EQ PRSX 


- END 


tIt is recommended that you use extended reprieve processing (refer to section 10) rather 


than EREXIT wherever possible. 
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The following information is returned to location RA+O if an error occurs at any time after 
an EREXIT request. 


TModels 171, 172, 173, 174, 175, 720, 730, 750, 760, 865, and 875 only. 
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59 53 


mo 


aaaaaa 


ef 


ssw 


47 


Mode of CPU error exit. 


mo Bit EM Bit 


53 
52 
51 
50 
49 
48 


29 23 "1 5 () 
se 


For ail computer systems except the model 176, 
the mode bit is set for the indicated EM register bit (refer to Exchange 
Package Area, appendix E). 


‘CM data error.t 


CMC input error.f 


EEM flag register operation parity error.f 


Indefinite operand. 
Operand out of range. 
Address out of range. 


If an mo bit is not set, the error is due to an illegal instruction. 


For model 176, the following mode bits are set for the indicated PSD 


register bit (refer to Exchange Package Area, appendix E). 


mo Bit PSD Bit 


46 


Meaning 


CM error condition. 

Not used. 

Not used. 

Indefinite condition. 
Overflow condition. 

LCME block range condition. 
CM block range condition. 
LCME direct range condition. 
CM direct range condition. 
Program range condition. 


The LCME error condition (PSD bit 47) and step condition (PSD bit 39) 


are not mapped to mo. 


CPU address of the job when the error occurred. 


Error flag. Refer to appendix E for a list of error flags. 


Status of sense switches. 
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ROLLOUT (006) 


‘The ROLLOUT macro places a job in the rollout queue until a specified event occurs or for a 


fixed period of time. This function may be useful if a program requires a direct access 
permanent file that is currently busy. 


Macro format :f 


Location Operation Variable 
, ROLLOUT addr 
addr Address containing the time and/or event dependencies; if addr is not 


specified, the job is rolled out without time or event dependencies. 


The following information must be set at location addr: 


59 32 : 11 ie) 
oor fe te 
evd . Event descriptor. System programs use the EESET macrott to make entries 


in a system event table indicating the occurrence of an event.’ The 
system compares the specified descriptor, evd, with events recorded in 
the table. If a match is detected, the job becomes eligible for rollin. 


evd#0 - -  evd and rtp are placed in the control point area 
‘ (TERW). When the job rolls out, the scheduler waits 

for the occurrence of evd or for the time period, 
rtp, to elapse before initiating rollin. Because the 
job may roll in for two different reasons, it is the 
user program’s responsibility to verify whether the 
specified event actually occurred. Refer to system 
OPL common deck COMSEVT for a list. of events. 


evd=0 The job scheduler uses the value of evd already in 

: the control point area. This option allows the user 
to roll out while waiting for a system-specified 
event. One such event is the event that is set up 
when an ATTACH request fails because of a busy file 
(refer to section 5). In this case, the event is the 
return of the file. 


evd=EXTM+00nng Specifies extended time rollout with no event 

(0200nng) - dependency. The job rolls out for (7777g x nn) + rtpg 
job scheduler delay intervals. The symbol EXTM is 
defined in the system OPL common deck COMSEVT. 


rtp Rollout time period in job scheduler delay intervals (roughly 1 second 
each) Ttf where O0<rtp<4095 (7777). 


If rtp is zero, the scheduler uses the value of rtp already in the control point area. If 
evd is also zero, the job rolls out waiting for a system specified event. If the event goes 
undetected or never occurs, the job rolls. in after a system-determined time interval. 


TThis macro is not available in SYSTEXT. The user program must specify. systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). ‘ 
‘tfObtain a listing of COMCMAC for internal documentation of the EESET macro and the ROLLOUT 
macro and for a description of valid event descriptors. - Ss 
TiTThe walue of the job scheduler delay interval varies from site to site. Contact your 
site analyst to determine the value at your site. 
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SETSSM (010) 


The SETSSM macro enables the user program to set or clear the secure system memory (SSM) 
flag. Setting this flag prevents the dumping of any portion of the job field length. 


While the SSM flag is set, certain system 
requests cannot be performed (refer to 
Security Considerations, section 1). In 
addition, certain system commands cannot be 
issued immediately following a program in 
which the SSM flag is set. Refer to 
Security Control in Volume 3, System 
Commands, for a list of these commands. 


Macro format: ft 


Location Operation Variable 
SETSSM ) 
P Clear SSM flag if lower 12 bits of p are zero; set SSM flag if lower 12 


bits of p are nonzero. 


tThis macro is not available in SYSTEXT. The user. program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). . & 
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ONSW (011) 


The ONSW macro sets the sense switches for a program (refer to figure E-l). This allows the: 
user program to set switches for options for subsequent job steps in the job. 


The sense switches reside both in the job’s control point area and in bits 11 through 6 of 
RA+O of the job field length. The field in RA+0 may be used by the user program to check 
sense switch settings; however, changing a bit in RA+0 will not cause the bit in the control 
point area to be changed. The field in RAH is set equal to the field in the control point 
area at the beginning of each job step, or if an error occurs. An ONSW (or OFFSW) request 


‘ updates both fields separately. 


The bit position specifies the switch to be set. 


Macro format: 


Location _ Operation | Variable 
ONSW on 
ns. Switches to be set; 0<n<779; bit O corresponds to switch 1, bit 1 


corresponds to switch 2, and so forth. If a bit is set, the - 
corresponding switch is set; for example, ONSW 52g sets switches 2, 4, 
and 6. If n=77g, all switches are set. If n=0, all switches remain 
unchanged. 


OFFSW (012). 


The OFFSW macro enables the user program to clear the sense switches for the job. Refer to 
the description of the ONSW macro for a discussion of sense switch settings. 


Macro format: 


Location Operation Variable 
OFFSW n 
n Switches to be cleared; O<n<779; bit.0 corresponds to switch 1, bit 1 


corresponds to switch 2, and so forth. If a bit is set, the 
corresponding switch is cleared; for example, OFFSW'52g clears sense 
switches 2, 4, and 6. If n=77g, all switches area cleared. If n=0, 
all switches remain unchanged. . 
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GETJN (013) 


The GETJN function allows the user. program to determine the job sequence name (JSN) of the 
job. For the format of the JSN, refer to Volume 3, System Commands. 


Macro format: T 


Location Operation Variable 
GETJN addr 
addr Address. to receive job sequence name, left-justified. 


The following information is returned to location addr: 


59 — 38 0) 
jen Job sequence name for the job. 


GETPR (015) 


The GETPR function allows the user program to determine the CPU priority of the current job. 


Macro format: T 


Location Operation Variable 
GETPR addr 
addr Address where the CPU priority is returned. 


The following information is returned to location addr: 


59 ; 1 ce) 
pr CPU priority. 


This macro is not available in SYSTEXT. The user must specify systems text PSSTEXT or 
call common deck COMCMAC (refer to appendix F). 
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GETEM (016) 


The GETEM macro enables the user program to devaratnas under what exit mode the job is 
currently running. 


Macro format :t 


Location Operation Variable 
GETEM addr ; 
addr Address for return of current exit mode in bits 11 through 0. 


GETASL (017) | 
The GETASL macro returns the account block SRU limit for the job Geefer x to SETASL macro) to 
the specified address. ; 


Macro format:t 


Location Operation Variable 


GETASL addr 
addr ; Address to receive account block SRU limit. 


. The following information is returned to location addr: 


59 17 ry) 


s Account block SRU limit. 


fThis macro is not available in SYSTEXT. The user “program must specify systems text PSSTEXT 


or call common deck COMCMAC or COMCCMD (refer to appendix F). 
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GETJSL (017) 


The GETJSL macro, returns the job step SRU limit for the current job step (refer to SETJSL 
macro) to the specified address. 


Macro format: f 


Location Operation Variable 
GETJSL addr 
addr Address to receive job step SRU limit. 


The following information is returned to location addr: 


59 17 (e] 
s Job step SRU limit. 


GETTL (017) 
The GETTL.macro returns the time limit for the current job. step. 


Macro format: fT 


Location Operation Variable 
GETTL addr 
addr Address to receive time limit. 


The following information is returned to location addr: 


59 17 (e) 
tl CPU job step time limit (in seconds). 


{This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD or COMCMAC (refer to appendix F). 
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SETLC (022). 


The SETLC macro enables the user program to set the loader control word for subsequent 
loader requests. : : : 


Macro format: - 


Location Operation Variable 
SETLC _ addr 
addr Address of the loader control word to be set. 


The following information must be set in location addr: 


23 17 1 5 {e) 
oe ee es 


NWOT. 


59 57 53. 


pe G 
oder pre 7 
Field Bit(s) Description 
v 59 Map validation bit. If bit is not set, default map option is used. 
1 58 If bit is set, global library set is active. 
me 57-54 Map control bits (octal): 
00... No map is produced. 
ol Statistics and errors. 
02 ' Block assignments. ; 
. 03 Partial map providing statistics, errors, and block 
assignments. : 
04 Entry points. : 
14 External references and entry points. 
17° -* ~~ Full map providing information given individually by 
‘control bits 01, 02, 03, and 14. 
n 53 Prevents: field length reduction after relocatable load. 
E & 49 If bit is set, request relocatable load from user library. 
u 48 If bit is set, program was loaded from a user library. 
g 23-0 Global library set indicators. 


The global library set indicators, contained in the loader control word 
(location LB1W in the user’s control point area), are maintained by the SETLC 
macro. The user program should call the GETLC macro before using the SETLC 
macro to avoid destroying the library set information. With the GETLC macro, 
the user program can obtain the current loader control word. The program can 
then change the v, mc, and n fields, and issue a SETLC macro. 


tThis macro is not available to SYSTEXT.. The user program must specify-systems text 
'.PSSTEXT or call common deck COMCCMD (refer to appendix F). 
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SETRFL (023) 


The SETRFL macro sets the initial central memory and extended memory field lengths for a job 
step. The specified values are used unless the system encounters one of the following: 


e A system routine whose field lengths are specified during system creation. 


e A routine that specifies the amount of CM or extended memory field length required 


in a 54 loader table (refer to CYBER Loader Reference Manual). 


e An MFL or RFL command (refer to Volume 3, System Commands) or a subsequent SETMFL or 


SETRFL macro. 


If you do not use the SETRFL function or the RFL command, the operating system determines 


how much field length to assign initially for each job step. 


The CM field length is rounded upward to a multiple of 100g words. The extended memory 


field length is rounded upward to a multiple of 1000g words. 


The values specified for CM field length and EM field length cannot exceed the current MFL 


values for the job (refer to the SETMFL macro in this section). 


Macro format:t 


Location Operation Variable 
SETRFL n,m 
n New CM field length parameter. 
m New extended memory field length parameter. 


This request does not change the amount of 
memory currently available for use by the 
user program. To change the amount of 
memory currently available for use, use the 
MEMORY macro. 


tT This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). 
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GETJCR (024)? 


The GETJCR jmacro enables the user program to interrogate the job control. registers 


associated with the job (refer to the description of execution control commands in Volume 3, 


System Commands). The last error flag encountered can also be determined. 


Macro format: Tf 


Location Operation Variable 
GETJCR : addr 
addr Address for return of the job control registers. 


The following information is returned to location. addr: . ' 


pef The last error flag encountered (refer to the EREXIT function Ek the 
values). 

R3 Job control register 3. 

R2 Job ential register 2. : : 

Rl Job control register 1. 


¥ You may choose to use the GETJCI macro instead of GETJCR, since GETJCI returns more - 
information. 

TT This macro is not available in SYSTEXT. The user program must specify. systems ‘text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). ; . 
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SETJCR (025)T 


The SETJCR macro enables the user program to set the job control registers for the job. 
Refer to the description of the GETJCR macro for the format of the word. 


Macro format: Tf. 


Location Operation Variable 
SETJCR addr 
addr Address of the word containing the job control registers to be set. 


The following information must be set at location addr: 


pef Previous error flag. 

R3 Job control register 3. 
R2 Job control register 2. 
Rl Job control register 1. 


SETSS (026) 


The SETSS macro changes the interactive subsystem under which your job is currently 
executing, provided you are validated for that subsystem. 


‘Macro format :tt 


Location Operation Variable 
SETSS ss 
ss Subsystem ordinal (refer to the TSTATUS macro, section 11, for a 


description of subsystem ordinals). 


TYou should use the SETJCI macro instead of SETJCR. 
TfThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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GETJO (027) | 
The GETJO macro returns the job origin code to the specified address. 


Macro format: 


_ Location Operation Variable 
GETJO addr 
addr. Address to receive job origin code.. Refer to appéndix E for legal job 


origin codes. 


The following information is returned to location addr:, 


38 its so 
ve 
jo Job origin seas - 
GETJA (030) * = A ; 


_The GETJA macro returns a five-word reply block containing job accounting information 
beginning at the specified address. ie 


Macro format:T 


Location Operation Variable 
GETJA addr 
addr Address of reply block. 


- The following information is returned to the five-word reply block beginning at location 
addr: 


59 41 39 28 19 re) 


addr +0 SRU accumulator (micro units #10) 
+1 CP accumulator (quarter nanounits) a 
v2 
= oe ds 


Nanounits are calculated as nanoseconds multiplied by the CPU accounting: multiplier (refer 
to Resource Accounting in section 5 of the NOS 2 Administration Handbook). 


fThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). : 


- 60459690 D — . | : 6-17. 


USECPU (031) 


The USECPU macro specifies which central processor is to be used when more than one is 
available. 


Macro format: 


Location Operation Variable 
USECPU n 
n Description 
0 Either central processor can be used. 


1 CPU 0 is to be used (the CPU with functional units on a 6700 or CDC 
CYBER 74-2x). . 


2 CPU 1 is to be used (the CPU without functional units on a 6700 or CDC 
CYBER 74-2x). 


USERNUM (032) 


The USERNUM macro returns the user name under which the job is running to the specified 
address. E 


Macro format: 


Location Operation Variable 
USERNUM addr 
addr Address to receive the user name, left-justified and zero-filled. 
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- GETFLC (033, 055) 


The GETFLC macro returns the field length control word from the. job’ s control point area to 
the Bpceketed address. 


Macro format: f 


Location Operation Variable 


GETFLC caddr,eaddr 
caddr Address to receive the central memory field length control word. 
eaddr Address to receive the extended memory field length control word. 


The GETFLC request can include either or both of the addresses. The field length control 
words are returned in the following format (multiply each 12-bit field by 100g for caddr 
or 1000g for eaddr to obtain the actual value). 


mf1 Maximum CM or extended memory field length for the current job step. 
‘This value may be reset with the MFL command (refer to Volume 3, System 
Commands) or the SETMFL macro. 


rfl Initial running CM or extended memory field length for a job step. This 
value is always less than or equal to mfl and is set with the RFL 
command’ or the SETRFL macro. A value of zero.indicates that the system 
controls the field length. * : 


jmf1 Maximum CM-or extended memory field length : fot the entire job. The jmfl 
represents the upper bound on mfl. ; 

rifl CM or extended memory field length for the job when it is to be rolled 
in. 

flir CM or extended memory field length increase requested. 


{This macro is not available in SYSTEXT. The user program must specify Ay EEeuP. text 
PeSTExt or call common deck COMCMAC cee to panpend ix F). ; 
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PACKNAM (035) 7 oN, 


The PACKNAM (035) request specifies a default pack name and device type for your job. It 
allows the user program to omit the pn and r parameters from PFM requests for files residing 
on the auxiliary device. If a PACKNAM request is in effect and you wish to access permanent 
files on another auxiliary device, you can either specify the pn and r parameters in the PFM 
request or issue another PACKNAM macro. To access permanent files on your permanent file 
family device while a PACKNAM request is in effect, either specify a display code zero as 
the pn parameter in the PFM request or issue another PACKNAM macro with a binary zero pack 
name. 


Macro format:T 


Location Operation Variable 
PACKNAM addr , 
addr Address of parameter word. 


Parameter word format: 


59 17 0 


packname One~ to seven-character alphanumeric pack name, left-justified, 
zero-filled. If this field is binary zero, any existing pack name and 
device type are cleared. 


dt Three-character alphanumeric device type. The first two characters 
represent the type of auxiliary device (refer to appendix E); the third 
character indicates the number of spindles in a multispindle device. If 
the third character is omitted, the default is 1; if the entire field is 
zero, the default is the system pack type (set by the installation). 


TThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck _COMCCMD (refer to appendix F). 
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PACKNAM (036) 


The PACKNAM (036) request returns the default pack name and device type to the specified 
address. 


Macro format:f 


Location Operation Variable 
PACKNAM addr,N 
addr Address to which the pack name and device type are to be returned. 


N Indicates that the pack name and device type are to be returned. 


The following information is returned to location addr: 


59 : 17 0 


a 


packnane One- to seven-character alphanumeric default pack name, left-justified,. 
zero-filled. (If no pack name is set, binary zero is returned.) 


dt. Three-character alphanumeric default device type. The first two 
: - characters represent the type of auxiliary device (refer to appendix E); 
' the third character indicates the number of spindles in a multispindle 
device. 


GETSS (0373 


The GETSS macro returns the current subsystem ordinal to the specified address. 


Macro ‘format :tt 


Location Operation ' ‘Variable 


GETSS addr 
addr Address to receive subsystem ordinal (refer to TSTATUS macro, section 


11, for a description of subsystem ordinals). 


The following information is returned to location addr: 


59 20 


‘addr . 0 [=] 


ss ‘Subsystem ordinal. 


i - . 
é 


TThis macro is not available in SYSTEXT. The user program must apecity systems ‘text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). ; tin 84 

TilThis macro is not available in SYSTEXT. -The user must specify systems text PSSTEXT or 
call common deck COMCMAC (refer to appendix F). 
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VERSION (044) 


The VERSION macro returns the version name of the operating system (and, optionally, the 


system title line) from central memory to the specified location. 


Macro format:f 


Location Operation Variable 
VERSION addr 
addr Address of word containing macro parameters. 


The following information must be specified at location addr: 


59 17 fe] 


47 35 23 
adde[t] be Tish | two 


t If set, indicates that the system title line is to be returned in 


addition to the operating system version name. 


be Number of bytestf (1 to 10 or, if t is specified, 1 to 30) to return 
from source field (CM location containing version name and, optionally, 


system title). 


sb Bytett in source field at which to begin transfer (0 to 9 or, if t is 
specified, 0 to 29); the sum of be and sb must be less than 11 (less 


than 31 if t is specified). 


bp Byteft position within receiving field (waddr) at which to begin 


transfer (0 to 4). 


waddr Beginning address of three-word block (seven-word block if t is 


specified) to receive data. 


JThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 


or call common deck COMCCMD or COMCMAC (refer to appendix F). 


TTIn ‘this context, the term byte refers to a 12-bit (2-character) field. 
bytes in a CM word, numbered from 0 to 4 from left to right. 


There are five 
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GETLC (045) 


The GETLC macro returns the loader control word to the specified address. “Refer to the 
SETLC macro for the format of the loader control word. ; : . 


Macro format: f 


Location Operation ~. Variable 
GETLC =°—S—S—Ssésaadddr 
. addr Address to receive the loader control word. 


GETGLS (046) 


The GETGLS macro returns the global library set from the job’s control point area. Refer to 
the CYBER Loader Version 1 Reference Manual for a discussion of global library sets. A 
parameter word is used to specify where a list of logical file names is to be placed. 


Macro format: tt 


Location Operation Variable 


GETGLS' addr 
addr Address of parameter word. 


Parameter word format: 


list Beginning address to which the logical file names (left-justified) 
contained in the global library set are written. The value of this 
parameter is updated to the address of the word following the last 
library (list+tn+l) upon completion. 


TThis macro is not available in SYSTEXT. The user program must apecity Systems text 
PSSTEXT or call common deck COMCCMD or COMCMAC (refer to appendix F). 
This macro is not available in SYSTEXT.’ The user program must specify systems ite 
PSSTEST or call common deck ,COMCMAC (refer to appendix F). 
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The following information is returned to locations list through list+n: 


F ss 7 tf 


YY 


y V/A 
CU: 


list+n lfn of last Sibrary 
n The number of libraries defined in the global library set minus one. 
.1fn The name of a global local library or the name of a system library. 


SETGLS (047) 


The SETGLS macro enables the user program to define the global library set indicators in the 
job’s control point area. Refer to the CYBER Loader Version 1 Reference Manual for a 
discussion of global library sets. A parameter word specifies where the list of logical 
file names used to define the global library set is located. 


Macro format:T 


Location Operation Variable 
SETGLS addr 
addr Address of parameter word. 


Parameter word format: 


59 53 35 - 0 


Te es ee 


list Beginning address to which the logical file names (left~justified) 
contained in the global library set are written. The value of this 
parameter is updated to the address of the last library (list+n) upon 
completion. If an error is encountered, list will be the address of the 
lfn of the library that caused the error. 


f This macro is not available in SYSTEXT. The user program must specify a text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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Before calling the SETGLS macro, locations list through list+n+l must be as follows: 


+2 


= 


ul 


eas ee 
n . ' The number of libraries ers global library set minus one. 


MACHID (050) 


The MACHID macro enables the user program to detesut ne the one~ or two-character machine 
identification. 


Macro format:f 


Location Operation Variable 
MACHID addr 
addr Address to receive machine identification. 


The following information is returned to location addr: * 


id Machine identification. 


The MACHID macro returns the value specified in the MID entry of the CMRDECK. ‘ 


_GETACT (051) 


The GETACT macro obtains information regarding outstanding system activity for your: job. 


Macro format:f 


Location Operation Variable 
GETACT addr 
addr Address to receive information. 


{This macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix F). 
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| The following information is returned to location addr: 


7 23 uu ie) 


59. 4 
reserved for 
csar {sco e]_ reserved | inetatiotion | reserved | 


sca Count of system completable activities. 


Q Long-term activity pending. 


The sca field is incremented by one for each of the following: 


e PP activity outstanding. This includes any PP routines called without auto recall 
that have not yet completed (for example, CIO). The following PPs are not included: 


= The PP that is processing the GETACT request. 
- PPs that have moved away from your job’s control point at the time the 
GETACT request is being processed and then move back to your job’s control 


point. 


- For jobs running under DIS control, the PP in which DIS is executing. 


r Tape I/O activity outstanding or PP routine(s) in recall. Although the tape 
activity is initiated through CIO requests, it is handled separately by the system 
and is counted here, not with the PP activity. 


e The rollout flag is set for your job. 
e An interactive I/O request that has been made but not yet processed. 
e Any SCP wait response invieatdrs are set. 
If & (bit 47) is equal to 1, a long-term activity is pending. Such an activity requires 


either termination by the user or operator intervention. The following are long-term 
activities. 


e K or L console display interface. 
e CFO flag set (refer to Volume 3, System Commands, for a description of CFO entries). 
e A system control point (SCP) long-term connection. 


C ) DIS. 
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SETMFL (052). 


The SETMFL macro enables you to change the job step maximum field length (MFL): boundary 


(refer to GETFLC and SETRFL macros for discussion of maximum field length limit). 


Macro format: f. 


Location Operation Variable 


SETMFL n,m 


New maximum central memory field length limit for job step. 


New maximum extended memory FL/1000g limit for job step. 


GETPFP (057) 


If either © 
parameter is 0, the maximum field length is set to your maximum allowable field length. 


The GETPFP macro returns a job’s permanent file parameters (current family name, pack name, 


device type, user name, and user index). 


Macro format: f 


Location Operation: Variable 


GETPFP addr 


addr 


The following information is returned to location addr: 


59 7 oO. 


+2 


user name ; user index 


?This macro is not available in SYSTEXT. The user program must specify systems text 
“PSSTEXT or call common deck COMCCMD or COMCMAC (refer to appendix F). 
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Address to receive three-word table containing permanent file parameters. 
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GETLOF (061) 


The GETLOF macro returns the list of files pointer for your job to the specified address. 
The list of files pointer is set with the SETLOF macro. 


Macro format: f 


Location Operation Variable 
GETLOF addr 
addr Address to receive the list of files pointer. 


The following information is returned to location addr: 


pointer Address of list of files table established with the SETLOF macro. 


¢ Completion bit. 


If the system returns 0 in the pointer field, no list of files address has been previously 
set (refer to description of SETLOF macro). 


SETLOF (062) 


The SETLOF macro enables the user program to specify a pointer to a list of files whose 
circular buffers will be flushed at job step abort or, for terminal files, when the job is 
rolled out or when the user program issues a read with recall request on INPUT. 


Macro format: Tf 


Location Operation Variable 
SETLOF addr 
addr Address containing the pointer to the list of files table. 


The following information must be specified at location addr: 


pointer Address of list of files table. 
c Completion bit. 


f This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). 
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The list of files table has the following format. ~ 


pointer +O 
+41 


+2 


t+len-2 
+len-1 
nm _ Common memory manager (CMM) block indicator; setting this bit indicates 
that the file list is CMM controlled. 
len _ Length of the list of files table including zero termination word. 
f . : 
lfny ' File name. 
fet; . FET address. 


The length of the list of files list must not exceed 7777, words. 


When used with an interactive job step, the first file in the list must’. be the terminal 
output file. 


During job step completion and after an error condition has occurred, the system uses the 
list of files to determine which files to complete for the user program. If the file name: 
is OUTPUT or the FET has the flush bit set and the flushing criteria are met (refer to the 


description of the flush bit, FET Description in section 2), the data in the circular buffer 
is written to the specified file. 


GETJCI (074) 


The GETJCI macro returns job control information to the specified address. 


Macro format: f 


Location - Operation Variable 
GETJCI addr 
addr Address of table to receive job control information. 


{This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD trefer to appendix F). . 
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The following information’ is returned to the two words beginning at location addr. 


59 53 35 23 17 11 5 0 


efg Global error flag (refer to Volume 3, System Commands, for a description 
of global error flag). 


RIG Global register. 

cel Reserved for system use. 

em Exit mode (as described in appendix E). & 
ssw Sense switches (as described for ONSW nacwa ye 

ef The last error flag encountered (as described for EREXIT macro). 

R3 Job control register 3. 

R2 Job control register 2. 


R1 Job control register 1. @ 


SETJCI (074) 


The SETJCI macro sets job control information with values obtained from a two-word table. 


Macro format: fT 


Location Operation Variable : @ 
SETJCI addr 
addr Address of table specifying job control information. 


The job control information must be established in the same format as that described for the 
GETJCI macro. The exit mode field is ignored for all jobs and the ccl field is ignored for 
user jobs. 


{This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCCMD (refer to appendix F). 
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PROTECT (075) é 


The PROTECT macro enables the user program to select or deselect the following job control 
features. ; 


@ &xtended memory field length preservation over job steps. 


@ User file privacy. 


Macro format: t 


Location Qperation Variable 
PROTECT em,ufp 
em ON to select extended memory preservation; OFF to deselect extended 


memory preservation. 


ufp ON to select user file privacy; OFF to deselect user file privacy. 
To specify extended memory field length preservation, you must be authorized to use the 
PROTECT command (refer to LIMITS command in Volume 3, System Commands) . 


If the user program issues the PROTECT macro with the ufp parameter set to ON, all files 
that are subsequently created or accessed in the current job step are returned at job step 
termination. If a PROTECT macro with the ufp parameter set to OFF is subsequently issued in 
the same job step, only those files created or accessed prior to the second PROTECT macro 
are returned. 


If the user program selects user file privacy, a checkpoint of the job step in which the 
PROTECT function is issued is not allowed. 


SETJOB (106) 


The SETJOB macro allows the user program to specify or to change the user job name (UJN), 
the disposition code for end-of-job output, and the end-of-job option. The user program 
must create a two-word parameter block containing this information before issuing the SETJOB 
call. 


Macro format: f 


Location Qperation Variable 
SETJOB addr 


addr Address of parameter block. 


{ This macro is not available in SYSTEXT.' The user program must specify systems text 
PSSTEXTor call common deck COMCCMD (refer to appendix F). 
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Parameter block format: 


59 23 17 11 0 


CO 
OWS ye ee | 


| ujn User job name (UJN) for the current job; one to seven alphanumeric or 

: asterisk (*) characters, left-justified, zero-filled. If binary zero, 
the current UJN remains in effect. The system initially assigns each 
job a UJN equal to the four-character user index hash or, for batch 
jobs, the name specified by the Job command. 


op End-of-job option. 
op Description 
SU _ Suspend job. 
Td Terminate job. 
dc Disposition of output at end of job. 
de Description 
DF Default queue for job; depends on job origin type (refer 
to appendix E). 
NO No output. 
TO Wait queue. 


If a field is set to binary zero, the corresponding option is not changed. 


GETSSID (110) 


The GETSSID macro returns the subsystem identifier to the specified address. 


Macro format: tf 


Location Operation Variable 
GETSSID addr 
addr Address to which subsystem identifier is returned. 


The following information is returned to location addr: 


59 11 it} 
es 
ssid Subsystem identifier. 


~ This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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GETJOSC (111) 


The GETJOSC macro returns the job origin and service class values to the specified address. 


Macro format:? 


Location Operation Variable 
GETJOSC addr 
addr Address to which job origin and service class values are returned. 


Refer to appendix E for a list of job origin and service class values. 


The following information is returned to location addr: 


59 11 5 0 


sc Service class. 


jo Job origin. 


SETSHC (113) 
SHELL (113) 


The SETSHC or SHELL macro allows you to specify controls for a shell program (refer to 
Volume 3, System Commands, for a description of shell programs). It also returns the 
current shell controls. 


Macro format: t 


Location Operation Variable 
SETSHC addr 
SHELL addr 
addr Address containing control information for a shell program; receives the 


current control information. 


{ This macro is not available in SYSTEXT. The user program must epecity systems text 


PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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The control information at address addr must have the following format. The current 
information will be returned to address addr in the same format. 


name One- to seven-character name of shell program. 
ctrl Control information for shell program. 
Bit Description 
11 Shell executing. If this bit is set in the information 


returned, the calling program is executing as a shell 
processor. If clear, the program is executing as a command. 
This bit has no function in setting shell controls. 


7 Clear control information if there are SHELL load errors. 


(If this bit is not set, the job is terminated on a SHELL 
load error.) 


6 Clear control information if shell program aborts. This bit 


must be set if a project epilogue is defined for the current 
account block. 


. 5 , Allow load of shell program from local file.t 
4 Allow load of shell program from global library.t 
3 Allow load of shell program from system library. 
2 Call shell program during interactive job when there are no 


more commands to process. 
1 Call shell program for each command outside a procedure. 


te) Call shell program for each command inside a procedure. 


+ A shell program loaded from a local file or global library must be in ABS or OVL format. 


You must ensure that there is sufficient field length if the program is to be loaded from 
a local file. 
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Example: 


To allow shell program ABC to be loaded from a global library and to monitor all commands, a 


user program could include the following statements. 


CTRL SET 
CTRL1 VFD 


CTRL1 


1844+1S82+1S1+1S0 
42/3LABC,11/0,7/CTRL 


Appendix L contains an illustration of a shell program that permits the use of non-NOS 


syntax commands. 
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GETJAL (116) 


The GETJAL macro returns your -job’s current security access level and the App: s security 
access level limits to the specified address. ot 


Macro format:t 


Location Operation Variable 
.GETJAL addr 
addr Address to which the job’s SECURE access level information is to be 
returned. 


The following information is returned to location addr: 


59 


. 17 11 5 o.: 


11 The numerical value of the job’s lower access level limit. 


ul The numerical value of the job’s upper access level limit. 
al _The numerical value of the job’s.current access level. 


' The system OPL common deck COMCVLC can be used to convert access level names to numerical 


values and vice versa. 


On an unsecured system, GETJAL returns a zero word to location addr. 


SETJAL (117) 


The SETJAL macro changes Ehe security access level of your job. This macro is valid only on 
a pccunee system. 
3 


Macro format: t 


Location Operation Variable 
SETJAL addr 
addr Address of a word containing the numerical value of the new access level 


for the job, right-justified with binary zero fill. The access level 
specified must be valid for your job (refer to Security Access Levels in ~ 
section 1). The access level specified may not be lower than the current 
job access level.unless you have special authorization. 


{This macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC. B ; ; . 
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GETUSC (123) 


The GETUSC macro returns the service classes valid for the user program for a particular job - 
origin type and indicates the upper and lower priority bounds for each of those service 


‘classes. The user program must contain a parameter block consisting of one word of parameters 


for the request and one word for each service class to be returned. 


Macro format:f 


Location Operation Variable 
GETUSC addr 
addr Address of parameter block. 


Parameter block format: 


59 47 36 35 0 


ay am EN RP ET 
cadet | se Tin i et 


| a 
cairn |e | im me 


The user program enters the following information into the parameter block: 


Field Location Description 

ot 35-24 The job origin type for which service class information is to be 
returned. 

len 23-12 The maximum number of service classes for which information is to be 


returned. The symbol MXJC, defined in common deck COMSSCD, can be 
used to specify the number of service classes in the system. Service 
classes are returned in increasing numerical order (refer to appendix 
E for a list of valid service classes and the numerical value 
associated with each class). 


c 0 ; Completion bit (must be set to zero). 


This macro is not available in SYSTEXT. The user program must specify Syanene text PSSTEXT 


or call common deck COMCMAC (refer to appendix F). 
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The user program must enter zeros in the remainder of word addr+0.. 


The following information is returned to the parameter block: 


Field Location 
len "23-12 
status li-1l 

c 0 

sc 59-48 
in 35-24 
ex 23-12 
out 11-0 


Description 


_ The actual number of service classes returned. 


Error status. 


Value Description 
0 No error. 
1 Value of zero specified for lens. 
2 Undefined origin type. 
3 Completion bit set in request. 


Completion bit (set when processing is complete). 


“Two-character display code mnemonic for the service class. 


Lower bound for input files in this service class. 


Priority upper bound; the highest possible priority for executing 


jobs in this service class. 


Priority ‘towed bound; the lowest poset ble ‘priority for output files 
in this service class. 


In the following example, the GETUSC macro is used to return information for all service 
classes for interactive origin type. 
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COMCMAC © REQUIRED FOR GETUSC MACRO 
COMSSCD DEFINES MXJC 

24/0, 12/1A0T, 12/MXJC, 12/0 

MXJC 

RE PLY 
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SETSC (124) 


The SETSC macro changes the service class of your job. 


Macro format:T 


Location Operation Variable 
SETSC addr 
addr Address of parameter word. 


Parameter word format: 


The user program enters the following information into the parameter word: 


sc Mnemonic or numerical value for the service class to which the job is to 
be assigned (refer to appendix E for a list of valid service classes and 
the mnemonic and numerical value associated with each class); you must 
use the system OPL common deck COMSSCD in order to specify a service 
class mnemonic. 


CPM returns the following information to the parameter word: 


err Error status. 
Value Description 
0 No error. 
1 Undefined service class. 
2 Service class not valid for user and job origin. 
3 Service class full. 


In the following example, the job’s service class is changed to batch service class (BCSC). 


OPL XTEXT COMSSCD 
OPL XTEXT COMCMAC 
PARAM VFD 54 /0,6/BCSC 


SETSC PARAM 


TThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCMAC (refer to appendix F). ; 
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_ GETPAGE (127) 


‘ The GETPAGE macro returns page size parameters to the specified address. 


Macro format:t 


Location Operation . Variable 
GETPAGE addr 


addr Address to which page size parameters are returned. 


The following information is returned to location addr: 


a) __ 31—Oo7 19 11 10 
wr [medics [#] # | » | = | 
[—waneatorcoe [wf |» | = 
jd Job print density in lines per inch (6 or 8). 
jl Job page length in lines. 
jw Job page. width in characters. 
c Complete bit. 
sd : System print density in lines per inch. 
sl System page length in lines. 
sw System page width in characters. 


SETPAGE (130) 


The SETPAGE macro allows the user program to specify page size parameters to control printed 


output. 


Macro format:t 


Location ‘Operation Variable 
SETPAGE addr 
addr Address of the word containing page. size parameters. All parameters must 


be specified with unused fields set to binary zero. 


59 31 


27 9 11 “10° 
we (oid eT 1d 
jd Job print density in lines per inch (6 or 8). 
jl , Job page length“in lines (16 < jl < 255). 
jw Job page width in characters (40 < jw < 255). 
c Completion bit (must be zero on entry). 


tThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 


‘or call common deck COMCMAC. 
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GETLVL (133) 


The GETLVL macro returns the PSR level of NOS that you are running. 


Macro format :f 


DSP FUNCTION 
Location Operation Variable 
GETLVL addr 
addr Address of the word to which the system level is to be returned. The 


system level is a binary number, right-justified with binary zero fill. 


GETRI (134) 


The GETRI macro returns information on your jobs current reprieve status to the specified 
address. 


Macro format: 


Location Operation Variable 
GETRI addr 
addr Address to which the reprieve information is to be returned. 


The following information is returned to location addr: 


59 5453 3635 24 23 18 17 


wa [tow | od ee 


flags If bit 59 is set, EREXIT processing is enabled. 
If bit 58 is set, normal reprieve processing is enabled. 
If bit 57 is set, extended reprieve processing is enabled. 
If bit 56 is set, normal reprieve is in progress. 
If bit 55 is set, extended reprieve is in progress. 


mask : Normal reprieve mask bits (if normal reprieve condition is set). Zero 
(otherwise). 


eaddr Extended reprieve parameter block address (if extended reprieve 
processing is enabled). 


Error exit return address (if normal reprieve processing is enabled or if 


EREXIT processing is enabled). Zero (otherwise). 


TThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 


or call common deck COMCCMD (refer to appendix F). 
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GETCN (136) 


The GETCN macro returns the charge and project number. 


The GETCN macro returns a four-word block containing the current charge and project number 
combination beginning at the specified address. Word four, bit 59, will be clear if this is 
a nonvalidated charge and project number. Word four, bit 59, will be set if these are 
validated numbers. (The only case in which the numbers would not have been validated is if 
your validation did not require you to have a valid charge and project number and your job” 
had never issued an explicit CHARGE command.) 


Macro format: 


Location Operation Variable 
GETCN . addr 
addr Address of the reply block. 


The following information is returned to the four-word reply block beginning at location 
addr: . : : 


59 0 
project number (first 10 characters) 
project number (second 10 characters) 


addr+0 


addr+1 


v Validation bit. 
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CSTATUS (137) 


The CSTATUS macro returns the type of the system console. 


Macro format: t 


Location Operation Variable 
CSTATUS addr 
addr Address of the word to which the console type is to be returned. 
59 48 47 0 
a A 
type Console type of primary console: 
0 = ¢cC545 
1 = CC634B 


GETSHC (143) 


The GETSHC macro returns the current shell control information. 


Macro format: 


Location Qperation Variable 
GETSHC addr 
addr Address of location to receive the current shell control information. 


See the SETSHC (113) macro for a description of this information. 


t This macro is not available in SYSTEXT. The user program must specify system text PSSTEXT 
or call common deck COMCDCM. 
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FILE ROUTING 7 


DSP FUNCTION 


The dispose processor (DSP) performs file routing operations for NOS. DSP places a file in 
the specified queue at either the central site or a remote batch site. A user program can 
“call DSP by issuing an RA+l request or a ROUTE macro. A DSP call can be made from a job of 

any job origin type. 


@ fascica 


If a file is routed to an input queue, it 
must contain a valid USER command or the job 
step initiating the route will be aborted 
with a security conflict. Refer to section 
1 of this manual for more information on 
security conflict processing. 


The format of the call to DSP is: 


@ 59 a ae 7 0 
rast [ose Ter 


R Auto recall bit. 


addr ‘First word address of parameter block. 
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The user program must define a parameter block containing the following information before 
issuing a DSP RA+l call or a ROUTE macro. 


Various symbols related to DSP calls and the 
DSP parameter block are defined in the 
system OPL common deck COMSDSP. 


s9 57) 53 47 4l 35 23 17 n 


te) 
G 


By setting bit 6 of the flags field in addr+l, the user program can define an extended DSP 
parameter block containing the following information. 


59 47 23 7 n 0 


a ee 


er 
encrypted password for input file (SSJ= only) reserved for CDC 
reserved for CDC 
reserved for installations - 


In general, a field in the DSP parameter 
block (or extended block) will only be 
processed if the corresponding bit in the 
flags (or eflags) field is set. 


addr +7 
+10 


+11 
+12 
+13 
+14 


+15 


+16 


| +17 
+20 
+21 


lfn Local file name of file to be routed (must be a queued file or a local 
file, must not reside on a removable device, and must not be an 
execute-only file). After the request is completed, this file name 
contains the JSN of the queued file (if bit 17 of flags was set). 


ec Error code returned by system when bit 12 of flags field is set (error 
| codes described later in this section). @ 
c Completion bit (must be zero when function is issued - system sets bit 
to one when operation is complete). 
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forms Forms code or input flags. Two display code characters or specific bits 
set identifying the forms to be used for this file or other processing 
options. If file is routed to input queue, this field is defined as 


follows: 

Bit (s) Description 

47-45 Reserved. 

44 Send file to input queue with forced abort error code. 

: 43 : Send file to input queue even if Job command error 
‘ occurs. 
42 A binary card sequence error occurred or an incorrect 
‘Hollerith code was detected in the card deck. 

41-36 Reserved. P 

; Forms codes consist of two alphanumeric characters and are assigned by 
& ; each installation. Forms code AC may be used on models 810 and 830 that 


have both a 64- and 95-character print train if the 95-character print 
train is required. You should contact installation personnel to 
determine what forms codes are available (if any). 


disp Disposition code. Two alphanumeric characters specifying the 
disposition of the routed file. 


Code Description 
int Release file to input queue. 

@ LP Print on any line printer. 
LR Print on 580-12 line printer. 
LS Print on 580-16 line printer. 
LT Print on 580-20 line printer. 
Lx Print on 5870 printer. : 
NO Release file to input queue. Drop job output files at job 

completion. 

PB Punch system binary. 
PH Punch coded. 
PL Plotter. 
PR Same as LP. 

& : PU Same as PH. 

; . P8 Punch 80 column binary. 
SB Same as PB. ; 
Sc Rescind prior routing and change file type to local 
(LOFT) . : 

TO Input queue, output to wait queue. 
TT Wait. 
wr Same as TT. 


+ When a job that has been routed to IN runs to completion, the following local files (if 
they exist) will be routed to the appropriate queues: OUTPUT, PUNCH, PUNCHB, and P8. You 
can prevent this implicit file routing with the SETJOB command or macro. 
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> 4 External characteristics of print files: 
ex Description 
0 Any external characteristics. 
1 Not used. 
2 ASCII graphic 48-character set (not supported; provided 
for NOS/BE compatibility) . 
3 Control Data graphic 48-character set (not supported; 


provided for NOS/BE compatibility) . 
Control Data graphic 63/64-character set. 
ASCII graphic 63/64-character set. 

ASCII graphic 95-character set. 

Reserved. 


“OV UT 


External characteristics of punch files: 


ex Description 


System default. 
System binary. 
80-column binary. 
Not used. 

026 mode. 

029 mode. 

ASCII. 

Reserved. 


NOU PWN E OC 


External characteristics of plot files: 


ex Description 


0 Reserved. 
1 Transparent 6-bit plotter data. 
2 Transparent 8-bit plotter data. 
-6 Not used. 
7 Reserved. 


8 Forced service class flag. If set, the specified service class will be 
used. 


ic Internal characteristics (bits 19 through 18) code: 


Value Description 


6-bit display code. 
7-bit (8/12) ASCII code. 
Binary. 

6/12 ASCII display code. 


WNF OO 


If ic is not specified, the system assigns a default value based on the 
value of ex. 
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ex for Print Files Default ic — 


au & Wh 


-K-Oo00Or 


ex for Punch Files Default ic 


1 2 
2 2 
4 aC) 
5 0 
6 l 
flags ' Each bit set indicates that a particular parameter is specified. 
Bit Description 
17 Job sequence name assigned to queued file by system is 
returned to addrt+0, bits 59 through 18. ! 
16 Accounting. 
15 580 PFC spacing code. 
14 Repeat count. 
13 UJN is’ specified in addr+3, bits 59 through 18. 
12 No dayfile message and' return error code to addr+0, bits 
17 through 12. 
ll Subsystem initiation. 
10 Forms code. 
9 Priority. 7 
8 Internal chaeaceerteeieas 
7 External characteristics. 
6 Extended parameter block. 
5 Reserved for installations. 
4 Disposition code. 
3 SLID/DLID. 
2 TID. 
1 Route to central site. 
0 Indicates either deferred ROUTE: (output files only) or 


forced JSN flag (input files only). 


The system determines the routing destination of an output file by flag 
bits 1 and 2 (route to central site and tid, respectively) as follows: 


Central 


Site Bit 


0 
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tid 
Bit Routing Activity 
0 If the calling job is of remote batch origin, 


the system routes output to the remote batch 
queue and associates with it the user name and 
family of the originating remote batch 
terminal. If the calling job is any other 
origin type, the system routes output to the 
central site queue. If the file being routed 
was previously routed with queuing deferred, 

_ the previously RECESS 3e9 destination remains in 

' effect. 


slid Three-character alphanumeric logical identifier (LID) of the source 
mainframe for the file. The following special values may also be 
entered in this field. 


Value (Octal) : Description 
0 Get slid from job input file system sector. 
1 . Set slid to. zero. 
2 . Set slid to physical identifier of this mainframe. 
dlid Three-character alphanumeric logical identifier (LID) of the destination 


mainframe for the file. The following special values may also be 
entered in this field. 


Value (Octal) . Description 
0. : Set dlid to zero. 
1 Set dlid to zero. 
2 , Set dlid to physical identifier of this mainframe. 
tid For routing to a remote batch queue, this field should contain the 


complement of the address of a two-word block. The first word of the 
block contains the family name and the second word contains the user 
name (both left-justified and zero-filled). This is the user name that 
must be used to log in at a remote terminal to get the routed file. 


If the address specified by the tid field equals 77777777, the file 
is routed to the remote batch queue with the family and user name of the 
calling job. 


For routing to the local batch queue, the tid contains an ID code (right- 


justified). 
ujn The user job name (UJN) to be used instead of the job’s default UJN. 
Central tid 
Site Bit Bit Routing Activity 
0 1 The system routes output according to the 
contents of the tid field (description follows). 
1 0 _ The system routes output to the central site 
queue. 
1 - 1 The system routes output to the central site 


queue if the tid field contains a valid ID 
code; otherwise, the system aborts the job. 


priority . If job priority is greater than 7760 octal, the specified priority is 
used for output files (otherwise field is ignored). 


p Print train image flag. This flag is set whenever the pi field contains 
a print train image code. 
pi. Print train image code (0 to 7) for print files. This field is 
meaningful only for 512 and 580 printers. 
spacing Spacing code for output files (580 PFC). Octal value from 0 to 77. 
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service 
class: 


abort code 


re 


binary 
card 
sequence 
error 
data 


eqid 


dd 


raddr 


eflags 


oun 
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Two-character forced service class code in display code, specifying the 


service class of the routed file. Refer to appendix E for a list of 


valid service classes and service class codes. 


If bit 44 of the DSP parameter word 1 is set, the value of this field 
determines which message from the following table is sent to the dayfile. 


Value Message 

0001 Job command error. 

0002 Card reader error. 

0003 ' Operator input termination. 
0004 Disk full. 

0005 Disk parity error. 


Repeat count. 


Used by the batch input/output subsystem. 


Equipment identifier in display code. For the Remote Batch Facility 
(RBF), terminal name; for the batch input/output subsystem, machine ID 
followed by EST ordinal of card reader; otherwise, EST ordinal of card 
reader, left-justified with zero-fill. 


The data declaration in display code. Defines the data type of a file 
destined to a remote mainframe. : ; 


dd : Data Type 

C6 6~bit character data. 

c8 8-bit character data. 

US . ‘Undefined data type, structured file. 
UU Undefined data type, unstructured file. 


Random address of the EOI sector of the file. 


Flags indicating which parameters are specified in the extended 
parameter block. 


Bit Description 


17-11 Reserved. 
10 Charge/project numbers (SSJ= only). 
Do not validate service class (SSJ= only). 
Special requeue operation (SSJ= only). 
Use encrypted password (SSJ= only). 
Use origin default service class (SSJ= only). 
Control point and subsystem identifier specified. 
Do not validate password (SSJ= only). 
Subsystem call (SSJ= only). 
Creator user name and/or creator family name (SSJ= only). 
Owner user name and/or owner family name (SSJ= only). 
Data declaration. ; 


Or nvNWFHUDN®W WO 


The user name of the file owner (SSJ= entry point only). 


irtaddr 


ofn 


ertaddr 


cun 
cp 
ssid 
cfn 


charge 
number 


project 
| number 


ROUTE 


Location 


addr 
R 


Example 1: 


printer. 


PBLK 
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The first word address of the block containing the implicit remote text 
string for the file (SSJ= entry point only). The first word of the 
block contains the length of the string in characters. The rest of the 
block contains up to 400g display-code characters. 

The family name of the file owner (SSJ= entry point only). 

The first word address of the block containing the explicit remote text 
string for the file (SSJ= entry point only). The first word of the 
block contains the length of the string in characters. The rest of the 
block contains up to 400g display-code characters. 

The user name of the file creator (SSJ= entry point only). 

Control point selection (subsystem initiation). 

Subsystem identifier (subsystem initiation). 

The family name of the file creator (SSJ= entry point only). 


The charge number associated with the file (SSJ= entry point only). 


The project number associated with the file (SSJ= entry point only). 


The format of the ROUTE macro is as follows: 
Operation Variable 


ROUTE addr,R 


Address of parameter block. 


Auto recall bit. 


The following example routes a file named PRINIF for printing on any central site line 


VFD 42/0LPRINTF,18/0 

VFD 24/0,12/2HLP,6/0,18/22B 
VFD 60/0 © 

VFD 60/0 

VFD 60/0 

VFD 60/0 

VFD 60/0 


ROUTE PBLK,R 
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Example 2: 


The following example performs a deferred route of a file named PRINTF in ASCII graphic 
95-character set and specifies that two copies be printed. 


PBLK VFD 42/OLPRINTF,18/0 

: VFD 24/0,12/2HLP, 3/6,3/0,18/40221B 

VFD 60/0 

VFD 60/0 

VFD 42/0,6/1,12/ 

VFD 60/0 : 
VFD 60/0 : 


ROUTE PBLK,R 


Example 3: 


The following example routes a file named JOB1 to the input queue for processing at the 
central site and writes the job name assigned by the system to the user dayfile. 


PBLK VFD 42/OLJOB1,18/0 
VFD 12/0,12/1000B,12/2HIN, 6/0,18/402022B 
VFD 60/0 ‘ 
VFD 60/0 

VFD 60/0 
VFD 60/0 
VFD 


60/0 


ROUTE PBLK,R 


. SAL PBLK 
MxO 42 
BX6 X0*X1 
SA6 Al 


MESSAGE “PBLK,3 
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ERROR PROCESSING 


When an error occurs in processing a ROUTE macro or DSP call, either a dayfile message 
explaining the error is issued, or an error code is returned in bits 17 through 12 of 
addr+0. If the address of the parameter block is outside the field length of the job or if 
the completion bit is set when the function is issued, the job step aborts. 


errors, the function is not executed, but error processing continues. 


For all other 


If bit 12 of the 


flags field is set, an error code is returned and no dayfile message is issued. If bit 12 
. is not set, no error code is returned, a dayfile message is issued, and the job step aborts. 


The error codes that can be returned are as follows: 


Error Codes 


NH UP WH 


10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
43 
44 
45 
46 
47 
50 
$1 


Description 


File name error. 

File not on mass storage. 

Invalid file type. 

Reserved. 

Route to input not immediate. 
Immediate routing, no file. 
Incorrect disposition code. 

User access not valid. 

Undefined service class. 

Incorrect request (unconditional abort). 
Deferred routing not allowed. 
Incorrect data declaration. 
Incorrect LID. 

Cannot route job input file. 
Completion bit already set (unconditional abort) . 
File on removable device. 
Incorrect TID. 

Forms code not alphanumeric. 
Incorrect internal characteristics. 
Queued file read error. 

QFT full. 

This routing not allowed. 

Device full. 

Mass storage error. 

I/O sequence error (unconditional abort) . 
Job command error. 

Too many deferred batch jobs. 
Incorrect USER command. 

Device inaccessible. 

Incorrect, file mode. 

Incorrect external characteristics. 
Incorrect origin type. 

Incorrect spacing code. 

Incorrect job abort code. 
Reserved. 

Reserved. 

Service class incorrect for user or job origin. 
Alternate family not allowed. 

User security count exhausted. 

JSN already in system. 

Alternate user not allowed. 


For a complete listing of error messages, refer to appendix B. 
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QUEUE ACCESS INTERFACE ar: 


4 , . =i 


The queue access (QAC) interface allows a user program to interact with the executing job 
table (EJT) and the queued file table (QFT). The user program can specify either a single 
entry (file or job) in a QAC request, or a group of entries. Requests are provided that 
allow a user program to: : 


4 


e Attach files that are in the QFT (GET request). 
e Determine the status of files in the QFT and jobs in the EJT (PEEK request). 
e Alter or purge files in the QFT and jobs in the EJT (ALTER request). 


A user program accesses the QAC interface by issuing an RA+1 call. The format of the call 
is: ‘ : 


+ 


eass[ ene UWL. ee 


59 17 


R Auto recall bit. 


addr a Address of the QAC parameter block; must be a valid address within your 
jobs field length. : : ; : 


The user program must define a parameter block before issuing the RA+l call. The first 
14g words of this ‘block are common.to all requests. ~~ 


Various symbols related to QAC calls and the 
QAC parameter block are defined in system 
OPL common deck COMSQAC. 


59 : 47 41 35 23 20 (17 119 ; ‘0 


Bs ce I ee se 
ae ene see Seen ee 


ee ee | 


ee 
eee ae 
1 ee 
| 
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Field 


lfn 


err 


Description 


The user program sets this field for a GET request to the local file 
name to be given to the queued file when it is attached from the queue. 
If this field is set to zero, QAC assigns the job sequence name (JSN) of 
the file as the local file name. 


QAC enters one of the following error codes upon completion of a 
request. Error codes 1 through 12g indicate nonfatal errors. During 


linked request processing, QAC continues with the next request when a 
nonfatal error is detected. 


err Description 
0 The request completed without error. 
1 Incorrect queue type. Indicates one of the following 


conditions. 
e Undefined queue bits (addr+10g) were set. 


e For a GET request, the executing job queue was 
selected. 


e Bit 0, addr+7 is set, but more than one queue was 
selected in addrt4. 


e The user program entered an invalid queue type in 
the queue field of addr+4 during an interrupted 
PEEK request. 


2 Incorrect family/user name. The specified family (addrt+5) 
or user name (addr+6) is not active or failed validation. 


3 Undefined origin type (addr+5). The specified origin type 
is not valid. 


4 The user program sets one of the following combinations of 
bits. 


e Bits 3 and 4 of the selection flags field (addr+7). 
e Bits 9 and 10 of the selection flags field (addrt+/). 
e Bits 0 and 1 of the alter flags field (addrtl4g), 

e Bits 10 and 11 of the alter flags field (addr+14g), 
e Bits 12 and 16 of the alter flags field (addr+14g), 


e Bits 9, 13, 14, and 15 of the alter flags field 
(addr+14g), 


5 Incorrect forms code. The forms code field (addr+17g) for 
an ALTER request does not consist of two alphanumeric 
characters or a zero. 
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Field 
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err 


10g 


1lg 


‘12g 


13g 


14g 
22g 


23g 


24g 


258 


268 


- 278 


30g 


519. 


Service class full. The service class change cannot be 


i | 
Description . oF 
Description 


- Incorrect disposition code (addr+l0g, or addr+l7g for an 


ALTER request), or the PU disposition code was selected but 
no external characteristics were specified to select a 
particular punch type. 


File or job not found. * 


Duplicate local file name. For a GET request, QAC refused 
to attach a file because the file has the same name as an 
existing local file. QAC enters the name of the file that 
caused the error in the 1fn field (addrt0O). This:‘condition 
does not result in an error if the inhibit SupLtCacs lfn : 
search flag (bit 1, addr+7) is set. 


brepeeeee batch ID. The batch ID specified (addr+5, or 
addr+l6g for an ALTER request) is not less than 70g. 


Incorrect file name. The local file name (addr+0) es 
for a GET request is not valid. 


Count of zero incorrect. The maximum number of files or 
jobs to be selected in a PEEK request (addr+l4g and 


addr+15g) for at least one queue must be greater than 
Zero. 


The user program did not set any alter Flags (addr+14g) 
for an ALTER request, or the QAC buffer is not large enough 


-to hold one PEEK reply for a PEEK request. 


Incorrect external characteristics. The external 
characteristics code (addr+17g) for an ALTER request is 
not valid. 


The user program attempted to drop an interactive job. 


Incorrect destination LID. The destination LID (addr+15g) 
for an ALTER request is not valid. 


ticorrect access (evel sk Bither the access level selection 
limits (addr+llg) or the new access level for an ALTER 
request (addr+17g) are not valid. 


Incorrect file size index. The file size index selection 
limits (addr+12g) are not valid. 


Incorrect service class. The two-character service class 
was not valid for the user, or not valid for the current 
origin type of the specified job. 


made because the number of jobs with that class is already 
at the service limit. 


Cannot change class of on-line job. The service class of 
another on-line job cannot be changed. .; ‘ 


Field —_ - Description 
err Description 
32g Undefined service class. The service class mnemonic is not 
defined. 
33g Job already waiting on service class. The service class 


change cannot be made because the job is waiting for a 
CLASS command in thé job to complete. 


34 Cannot change class of subsystem. The service class of a 
job that is executing at the subsystem service class cannot 
. be altered. 


35g The selected file could not be attached because the PRU 
limit for the job’s mass storage was exceeded during 
preparation of a local copy of a queued file. 


fen The user program enters the function code number for the type of request. 
Request fen 
ALTER 1 
GET 2 
PEEK 3 
c Completion bit. The user program must set this bit to zero. QAC sets 


this bit to one when the request is complete. 


len The user. program enters the total length of the QAC parameter block 
minus 5. The value of len for éach type of request is as follows: 


Request len 
ALTER 14, 
Extended GET 116. t 
GET : 13, 
PEEK 13g 
first The user program.enters the first word address of the buffer to be used 


by QAC. For an ALTER request, the user program can enter messages in 


‘the buffer; for a PEEK request, QAC enters the PEEK reply block in the 
buffer. ‘ : As 


in This field is a pointer to the next available word in the buffer to 
which information can be written. . For a PEEK request, the user program 
must set this field to the same value as first. ; 


out This field is a pointer to the’ next word that can be read from the 
buffer. For a PEEK request, the user program must set this field to the 
same value as. first. For an ALTER request involving a message, the user 
program enters the beginning address of the message. 


fnt ord QAC enters the FNT ordinal of. a file when the file is attached from a 
queue. ee a : 


words returned on an extended GET ‘is 123g words. Refer to the GET request in this 


| TAlthough 116g is used here as the total parameter block length, the actual number of 
section, 


8-4 60459690 H 


6 @ 


Field 


ejt/qft 
ord 


queue 


limit 


dest 
family 


id 
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Description 


The user program enters the QFT ordinal of the file or the EJT ordinal 
of the job if QAC is to process only the file or job having this 
ordinal. QAC. enters the QFT ordinal of a file when the file is attached 
during a GET request. For an initial PEEK request, the user program 
must set this field to zero. QAC enters the QFT or EJT ordinal of the 
file or job currently being examined if a PEEK request is interrupted 
because the QAC buffer is full. QAC enters a value of zero when the 
request is complete. 


QAC enters a value indicating the queue in which a file was found for a 
GET request, or the remaining queues to be examined for a PEEK request. 
The user program must set this field to zero for an initial PEEK request 
and must not alter its contents when issuing continuation calls. QAC 
enters a value of zero upon successful completion of a PEEK request. 


Bit(s) Queue 


0 Input queue. 
1 Executing job queue. 
2 Print queue. 
3 Punch queue. 
4 Plot queue. 
5 Wait queue. 


6-7 Reserved for Control Data. 
8 Reserved for installations. 
9-11 Reserved for Control Data. 


The user program’ enters the limit address (LWA+t1) of the buffer to be 
used by QAC. 


The user program enters the destination family name if QAC is to consider 
only one family (the program must also set bit 3, addr+7). This 
represents the family under which you would have to.log in to access the 
file or job at a remote batch terminal. A value of zero selects the 
default family name. QAC enters the destination family name of the file 
that is attached during a GET request. 


The user program enters an ID code if QAC is to consider only one ID code 
(the user program must also set bit 4, addr+7). QAC enters the ID code 
of the file attached during a GET request. 
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Field 


origin 


dest 
un 


dest 
ui 


jsn 


selection 
flags 


Description 


The user program enters a value if QAC is to examine files or jobs of — 
only one origin type (the program must also set bit 5, addr+7; if this 
bit is not set, QAC examines files and/or jobs of all types). On a GET 
request, the origin type of the attached file is returned in this field. 


Origin Origin type 
00 Caller’s origin. 
01 SYOT (system). 
02 BCOT (local batch). 
03 RBOT (remote batch). 
04 IAOT (interactive). 
05-77 Reserved. : 


The user program enters the destination user name if QAC is 

to consider files and/or jobs for only one destination user name (the 
program must also set bit 3, addr+7). This represents the user name 
under which you would have to log in to access the file or job at a 
remote batch terminal. QAC enters the user name of the file that is 
attached during a GET request. 


QAC enters the destination user index of the file that is 

attached during a GET request. This. represents the user index under 
which you would have to-.log in to access the file or job at a remote 
batch terminal... 

The user program enters the job sequence name (JSN) if QAC is to 
consider files and/or jobs for only one JSN (the user program must also 
set bit 6, addr+7). QAC enters the JSN of the file that is attached 
during a GET request. 


The user’ program sets the appropriate bits in this field to 

limit QAC’s search of jobs or files to specific types. . Where noted, 
these bits are used in conjunction with other fields in the parameter 
block to specify the type of job or file QAC is to search for. 


Bit(s) Description 
0 . ‘Specific ordinal (addr+4) and specific queue (addr+l0g), 
1 Inhibit. duplicate 1lfn searche If set, QAC will allow a 


file having the same name as a local file to be attached in 
a GET request. Otherwise, an attempt to attach such a file 
causes an error flag in addrt0 to be set and the request is 
terminated. 

2 Include priority=0 in selection. .If set, QAC will select 

files and/or jobs that have a priority of zero, provided 

‘they meet other selection criteria. 

Destination family name (addr+5) or destination user name 

(addr+6). 

ID code (addr+5). 

Origin type (addr+5). 

JSN (addrt+7). 

Forms code (addr+10g), 

Disposition code (addrt+l0g), 

Explicit external characteristics (addr+l0g), 

Hierarchical external characteristics (addr+10g), 

Include ec=0 (any external characteristics) in selection 

hierarchy (addr+10g). 


w 


FOUuoOntauS 


a on 
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Field 


queue 
sel 


forms 


disp 
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Description 

Bit(s) - Description 

12. Internal characteristics (addr+10g), 

13 Access level (addr+1lg). 

14 Destination LID (addr+l1lg), 

15 List of alternate destination LIDs (addrtllg). 

16 Source LID (addrtllg). 

17 Include LP disposition code in addition to disposition code 

selected (print files only). 

18 Select only recoverable jobs (detached interactive jobs). 
19 Reserved for Control Data. : j 
20 File size index range specified. , 


21-32 Reserved for Control Data. 
33-35 .- Reserved for installations. 


Bits 3 and 4 may not both be set, and bits 9 and 10 may not both be set. 
Bit 11 can be set only if bit 9 or bit 10 is set. Bit 17 can be set 
only if bit 8 is set. 


The user program sets one or more bits in this: field to indicate which 
queue or queues QAC is to consider. 


‘Bit(s) Queue 


0 Input queue. 
1 Executing job queue. 
2 Print queue. 
3 Punch queue. 
4 Plot queue. 
5 Wait queue. 


6-7 Reserved for Control Data. 
8 Reserved for installations. 
9-11 Reserved for Control Data. 


The user program enters a two-character alphanumeric forms code if QAC 
is to consider only files with a particular forms code (the program must 
also set bit 7, addr+7). QAC enters a forms code of the file that is 
attached during a GET request. 


The user program enters a two-character disposition’code if QAC is to 
consider only files with a particular disposition code (the program must 
also set bit 8, addrt7). QAC enters the ste poateton code of the file 
that is attached during a GET reterees 


disp Description 
IN Input queue. 
LP Print on any line printer. 
LR Print on 580-12 line printer. 
LS Print on 580-16 line printer. 
LT Print on 580-20 line printer. 
LX Print on 5870 printer. 
NO Input queue, no ‘OREDUES 
PL Plotter. 
PR Same as LP. 
PU Punch (specific punch type must be entered in the ec field). 


disp Description 
TO . Input queue, output to wait queue. “ 
TT Wait queue. 
WT Same as TT. 
| Field Description = 
ec The user program enters an external characteristics code if QAC is to 


consider only files with particular external characteristics (the 
program must also set bit 9, or 10, addr+7). QAC enters the external 
characteristics code of the file that is attached during a GET request. 


External characteristics of print files: 


ec Description : @ 


Any external characteristics. 

Not used. 

ASCII graphic 48-character set (not supported; provided 
for NOS/BE compatibility). 

CDC graphic 48-character set (not supported; provided for 
NOS/BE compatibility). 

CDC graphic 63/64-character set. 

ASCII graphic 63/64-character set. 

ASCII graphic 95-character set. 


Reserved. & 


External characteristics of punch files: 


Lot) NRO 


NOUS 


ec Description 


System default. 

System binary. 

80-column binary. 

Not used. 

026 mode. - 

029 mode. - : 
ASCII. & 


Reserved. 


NAUS WH KO 


External characteristics of plot files: 


ec Description 
0 Reserved. 
1 Transparent 6-bit plotter data. 
2 Transparent 8-bit plotter data. 
3-6 Not used. 
7 Reserved. 
If the user program sets bit 9 of addr+7 (explicit external » 


| characteristics), QAC searches only for files having the external 
| : characteristic selected. If the program sets bit 10 (hierarchical 
; external characteristics), QAC searches for files having compatible 


external characteristics. The following codes cause QAC to search for 
files in the order listed. 
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Field 


link addr 


slid 


diid 
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Description 


Hierarchical external characteristics for print files: 


ec Compatible Types 


0 ASCII graphic 95-character set, ASCII graphic 63/64- 


character set, ASCII graphic 48-character set, Control 
Data graphic 63/64-character set, Control Data graphic 
48-character set. 


4 Control Data graphic 63/64-character set, Control Data 
graphic 48-character set. 

5 ; ASCII graphic 63/64-character set, ASCII graphic 48- 
character set. ; 

6 ASCII graphic 95-character set, ASCII graphic 63/64- 


character set, ASCII graphic 48-character set. 


Hierarchical external characteristics for punch files: 


ec Compatible Types 

2 80-column binary, system binary. 
5 : 029, 026. 

6 . ASCII, 029, 026. 


The user program enters an internal characteristics code if QAC is to 
consider only files with particular internal characteristics (the 
program must also set bit 12, addr+7). QAC enters the internal 
characteristics code of the file that is attached during a GET request. 


> 


ic Description 


0 6-bit display code. 

1 7-bit (8/12) ASCII code. 
2. Binary. 

3 6/12 ASCII display code. 


The user program enters either zero or, in order to process linked QAC 
requests, the address of the next QAC parameter block. Any nonzero 
value entered in this field must be a valid address within the user 
program’s field length. Upon completion of the current request, QAC 
checks this field. If a nonzero value is present, QAC processes the 
request at address link addr. 


The user program enters the source logical identifier (LID) if QAC is to 
consider only files originating ‘at a particular mainframe. This field 
is processed if bit 16 of the selection flags field is set. A value of 
zero specifies only files without a source LID. QAC enters the source 
LID of the file that is attached during a GET request. 


The user program enters the destination logical identifier (LID) if QAC 
is to consider only files with a particular destination LID. This field 
is processed if bit 14 of the selection flags field is set. A value of 
zero specifies only files without a destination LID; a value of *** 
(4747473) specifies all files regardless of LID. QAC enters the 
destination LID of the file that is attached during a GET request. 


If bit 14 of the selection flags field is not set on a GET request, QAC 
selects either a file with no destination LID or a file whose 
destination LID refers to the local host mainframe. 


Field 


al 1b 


ai ub 


alid addr 


li 


ui 


Description 


The user program enters the access level lower bound if QAC is to 
consider only files with an access level equal to or greater than a 
particular value (the program must also set bit 13, addr+7). 


The user program enters the access level upper bound if QAC is to 
consider only files with an access level equal to or less than a 
particular value (the program must also set bit 13, addr+7). 


The user program enters the address of a list of alternate destination 
LIDs if QAC is to consider only files from that list of destination 
LIDs. The list of alternate LIDs has the following format: 


es 77/7 


alid addr +0 


+1. 


+n 


| alidanes | idee | ids V7 


The list is terminated by the first 18-bit zero field starting at bit 
59, 41, or 23. 


The user program enters the file size index lower bound if QAC is to 
consider only files with a file size index within a specified range (the 
program must also bet bit 20, addr+7). If 1i is specified, ui must also 
be specified, and 1i must be .LE. ui. 


The user program enters the file size index upper bound if QAC is to 
consider only files with a file size index within a specified range (the 
program must also set bit 20, addr+7). If ui is specified, 1i must also 
be specified, and ui must be .LE. li. 


QAC REQUESTS 


The following pages describe the three types of QAC requests: ALTER, GET, and PEEK. Each 


type of request uses a different format for the remainder of the parameter block following 
addr+13,. 
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ALTER REQUEST : 


The ALTER request changes characteristics of queued files or executing jobs. The alter 
flags in addr+l4g determine which characteristics the ALTER request is to change. QAC. 
cannot alter the calling job. : 


The format of the remainder of the parameter block for an ALTER request is as follows: 


35 23 20 17 11 


new dest family new dest lid 


TC // ant 
LL 
[reewed [tome [ate [eff oe | 

reserved for installations 


+ 15 
+ 16 
+417 
+ 20 


Field » + Description 
ssw _ ‘The user program enters bit values to which the sense switch settings of 


jobs are to be altered. Bits 54 through 59 correspond to sense switches 
1 through 6 respectively. If bit 10 of addr+14g (turn sense switches 
on) is set, the sense switches whose corresponding bits in this field 
are set to one are changed to one for the selected jobs. If bit 11 of 
‘addr+14. (turn sense switches off) is set, the sense switches whose 

‘ corresponding bits in this field are set to zero are changed to zero for 
the selected jobs. Refer to the ONSW and OFFSW macro descriptions in 
section 6 for descriptions of the individual sense switches. 


alter. The user sets the appropriate bits in this field to specify the 
flags. .. information that QAC is to alter. 

Bit(s) Description 
0 Change remote family name, user name. 
1 Change local batch identifier.’ 
2 Change priority of output SENS file. 
3 Alter forms code. 
4 ‘Alter spacing code. 
5 ‘Alter disposition code. 
6 Alter external: characteristics. 
7 Alter repeat count. gO 
8 Alter access level. 
9 _. Abort job or evict file. 
10. Turn sense switches on. 
ll _ Turn sense switches off. 
12 - ' Clear pause bit. 
13 Send comment to dayfile.. 
14 Send comment from operator. 
15 Indicate message available for aborted job. 
16 Set. pause bit. 
17 . Alter destination logical identifier. 
18 Kill job. 
19 Alter service class. 

-20-26 .. Reserved for Control Data. 

27-29 Reserved for installations. 
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Field 


new 
dest 
family 


new 
dest 
lid 


new 
dest 
un 


sp cd 


id 


forms 


disp 


ec 


al 


Description 


Bit 15 can be set only if bit 9 is set. Only one of bits 13, 14, and 15 
can be set. If bit 13, 14, or 15 is set, the program must enter a 
message in the QAC buffer defined by the fields FIRST, IN, OUT, and 
LIMIT. ; 


The user program enters the new destination family name for the files 
and/or jobs. The program must also set bit 0, addr+14g. QAC changes 
the destination family and routes the files/jobs to remote batch. The 
specified family must be known to the system but need not be active. If 
this field is selected and has a value of zero, QAC uses the family of 
the requesting job’s control point. 


The user program enters the new destination logical identifier (LID) for 
selected input and/or output files. The program must also set bit 17, 
addr+14.. 


The user program enters the new destination user name for the files 
and/or jobs. The program must also set bit 0, addr+l4g. QAC changes 
the destination user name and routes the files/jobs to remote batch. If 
this field is selected and has a value of zero, QAC uses the user number 
associated with the job in which the user program is executing. 


The user program enters the new spacing code for the files. This field 
affects only print files. The program must also set bit 4, addrtl4g, 
Values of 0 through 77g are accepted; if the value entered is not 
defined for the installation, the released default value (0) is used. 


For more information on spacing codes, refer to the NOS 2 Analysis 
Handbook, 


The user program enters the identifier for the local batch queue to 
which the files and/or jobs are to be routed. The program must also set 
bit 1, addr+l4g. 


The user program enters the new forms code for the files. This field 
affects only output files. The program must also set bit 3, 
addr+14g. This field may contain any two alphanumeric characters or 
zero. ‘ : 


The user program enters the new disposition code for the files. This 
field affects only output files. The program must also set bit 5, 
addr+l4g. Valid disposition codes are listed in the description of 
the disp field of addr+10g. 


The user program enters the new external characteristics code for the 
files. This field affects only output files. The user program must also 
set bit 6, addr+1l4g. Valid external characteristics codes are listed 

in the description of the ec field of addr+10g. A value of zero for a 
punch file selects the installation-defined default punch mode. 


The user program enters the new access level for the files. The program 
must also set bit 8, addrt+l4g. This field may contain any value from 

O through 7. (You can convert a symbolic access level name to a 
numerical value, or vice versa, using system OPL common deck COMCVLC. ) 
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Field- 


src 


rep 


Example: 


Description 


The user program enters the new service class for files in the input 
queue and for executing jobs. The program must also set bit 19, 
addr+l4g, This field does not affect output. files. The service class 
is specified as the first two characters in the display code of one of 
the service class mnemonics listed in appendix E. 


The user program enters the new repeat count for output files. The 
program must also set bit 7, addr+l4g,. The maximum value allowed is 778. 


The following program clears the pause bit in all executing jobs submitted under the 
same user name as the program (except the job in which the program is executing). ~The 
program also enters the message PROGRAM RESTART HAS CLEARED PAUSE BIT in the user 
dayfile of each job. This program uses the SYSTEM macro (refer to section 11) to issue 
the QAC request. 


ak 


MSG 
TAG1 


ak 


BLOCK 


kk 


RESTART 
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IDENT RESTART 
ENTRY RESTART 


MESSAGE BUFFER 


DATA C*PROGRAM RESTART HAS CLEARED PAUSE BIT* 
EQU  - *-MSG 


QAC PARAMETER BLOCK 


Bss. 0 

VED . 59/1,1/0 ALTER FUNCTION CODE 

VED  36/0,6/12,18/MSG MESSAGE BUFFER, FIRST 
VFD  42/0,18/MSG+TAG1 a pein 
VFD 42 /0,18/MSG , OUT 

VFD 42/0, 18/MSG+TAG1+1 " , LIMIT 
VFD 60/0 

VFD 60/0 

VFD 60/0 

VFD =: 12/2, 48/0 SELECT EXECUTING JOB QUEUE 
VFD 60/0 

VFD 60/0 

VFD 60/0 

VFD  60/2200008 CLEAR PAUSE BIT AND SEND 
VFD 60/0 COMMENT TO DAYFILE 

VFD 60/0 

VFD 60/0 

VFD 60/0 


MAIN PROGRAM 
SYSTEM QAC,R,BLOCK CALL QAC 
EN DR UN 


END RESTART 


8-13 


GET REQUEST 


The GET request attaches one of your queued files to your job in read mode. 


The attached file can be returned to the queue with a DSP call or a ROUTE macro. The user 
program can drop the attached file by issuing a RETURN macro. If the file remains attached 
when the job terminates, the file is returned to the queue from which it was attached. 


The format of the remainder of the parameter block for a GET request is as follows: 


59 
addr + 14 


Field 
dayfile 
random 
addr 

sc 


user 
limits 


interrupt 
random 
addr 


pi 

sp cd 
rep 
file 
length 
al 


fi 


ojsn 


29 ey 23 21 17 11 5 0 
dayfile random addr 


+1 ee ne 7am 


reserved for noe 


Description 


' QAC enters the random address of the first PRU of the queued file’s 


dayfile. If the file does not contain a dayfile, QAC enters a value of 
zero. This field applies only to prane files. 


QAC enters the service class of the file. Refer to appendix E for a 
list of valid service classes and their corresponding 6-bit octal values. 


QAC enters your authorized resource limit. that applies to the type of 
device to which the file is routed. A value of 777777778 is defined 
as unlimited. This field applies only to output files. 


If a GET request was pveniounly performed on a file and the file was 
later returned to the queue, QAC enters file position from the time the 
file was returned to the queue. This value can be used to reposition 
the file. 


QAC enters the print train image code for the queued file. If nonzero, 
the code is biased by 10g. 


QAC enters the spacing code of the queued file. This field applies only 
to print files. 


QAC returns the repeat count specified for the queued file. This field 
applies only to output files. ; . 


QAC enters the length of the file in PRUs. 


QAC enters the security access level of the file. 


QAC enters the file size index of the file. 


the JSN under which the file was created. 


QAC enters the original job sequence name (JSN) for the file. This is @ 
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An extended version of the GET function can be selected by entering a length of 116g in 
the len field in word addr+l of the QAC parameter block. The extended GET function returns 
additional accounting information and control information for remote host files. 


QAC returns the following information to addr+20g through addr+122g of the QAC parameter 
block for an extended GET request. Extended GET Pedueee parameter block (len field of 
addr+l of QAC parameter block = 116g): 


59 47 23 17 11 0 
: accounting information (word AHMT) 


addr + 20 
+ 21 accounting. information (word AHDS) : 
+ 22 ss eocounts information (word AACW) 
+ 26 = creation family name ; 
3 a ee ee 
+ 33 ar 
: implicit remote text string 
+ 64 
+ 65 rn 
: " explicit remote text string ; 
+116 ; ; 
+117 encrypted batch password for input file (SSJ= only) _ reserved for CDC 
+121 | 
ep? +122. , project number . 
_ Field a: get ~ 3 Description 
accounting Accounting words AHMT, AHDS, and AACW for the file. Refer to the 
information NOS 2 Administration. Handbook for descriptions of these words. 
owner user The user name ‘of the owner of the file. 
‘name Sees : 
owner family The family name of the owner of the file. 
name 
creation The user name of the creator of the file. 


user name 


creation — The family name of the creator ofthe file. 
family name : ‘ 


remote For remote host files; the user name under which the file is 
mainframe accessed.on a remote mainframe. ‘For other files, this field has a 
user name value of zero. ; 
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Field : Description 


remote For remote host files, the family name under which the file is 
mainframe accessed on a remote mainframe. For other files, this field has a 
family name value of zero. 

user job The user job name for the file. 

name 

data dec Data declaration field from DSP parameter block (files routed to 


remote mainframe using extended DSP request only). 


imp length Character length of implicit remote text string (remote host files 
only). 

exp length Character length of explicit remote text string (remote host files 
only). 

implicit For remote host files, a string of up to 400g characters that 

remote text contains parameters for the operating system under which the file 

string was created. For other files, this field has a value of zero. 

explicit For remote host files, an optional string of up to 400g characters 

remote text that form a job command in the job control language of the operating 

string system of the mainframe that is to process the file. For other 


files, this field has a value of zero. 


charge The charge number associated with the file. 


number 
project The project number associated with the file. 
number 


PEEK REQUEST 


The PEEK request examines selected queued files or executing jobs, and returns information 
about those files and/or jobs to the QAC buffer. The user program specifies which 
files/jobs QAC is to consider by setting the appropriate selection flags and their 
corresponding fields in words addr+0 through addr+l3g of the parameter block and selects 
the information about those files/jobs that QAC is to return. 


You can use the PEEK request to obtain a count of queued files and executing jobs that 
belong to you. To do this, include a -PEEK request in your program without setting any peek 
information bits; QAC will enter the number of queued files and executing jobs for your user 
name in words addr+l4g and addrt+l5g. ; 


When the QAC buffer is filled with PEEK reply information during a PEEK request, QAC enters 
the QFT or EJT ordinal of the file or job last examined in the ejt/qft ord field of addrt+4 
and enters the queue last examined in the queue field of addr+4. To issue a continuation 
call, the user program clears the completion bit (addr+0) and empties the QAC buffer by 
setting out (addr+3) to the value of in (addr+2). The program then reissues the RA+l call. 
QAC continues its search from the file or job at which it was interrupted. 


The format of the remainder of the parameter block for a PEEK request is as follows: 
59 47 35 

ee eee 
| mont LLL | ant tenath | 


; peek information bits . 


reserved for installations : 
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23 11 0 


addr + 14 


+ 15 
+ 16 
+ 17 


Field 


incnt 


excnt 


prent 


phent 


plent 


wtcnt 


isent 


ent 
length 


peek 


Description 


If no peek information bits are set (addrt+l6g), QAC enters the number 
of files in the input queue that are eligible for selection. For any 
input queue files to be eligible for selection, the user program must 
set bit 0 of the queue sel field, addr+10g, 


If any peek information bits.are set, the user program must enter the 
maximum number of files to be selected from the input queue. When the 
PEEK request is completed, QAC enters the actual number of input queue 
files selected. 


This field is used in the same manner as the incnt field, except that it 
applies to jobs in the executing job queue. For any jobs in the 
executing job queue to be eligible for selection, the user program must 
set bit 1 of the queue sel field, addr+10g. 


This field is used in the same manner as the incnt field, except that it 
applies to files in the print queue. For any print queue files to be 
eligible for selection, the user program must set bit 2 of the queue sel 
field, addr+1l0g, 


This field is used in the same manner as the incnt field, except that it 
applies to files in the punch queue. For any punch queue files to be 
eligible for selection, the user program must set bit 3 of the queue sel 
field, addr+10g, 


This field is used in the same manner as the incnt field, except that it 
applies to files in the plot queue. For any plot queue files to be 
eligible for selection, the user program must set bit 4 of the queue sel 
field, addr+10g. 


This field is used in the same manner as the incnt field, except that it 
applies to files in the wait queue. For any wait queue files to be 
eligible for selection, the user program must set bit 5 of the queue sel 
field, addr+10g. 


This field is reserved for installations. 


QAC enters the length, in words, of each reply in the PEEK reply buffer. 
If no PEEK information bits are set, no value is returned by QAC, and an 
entry length of zero is returned in the PEEK reply block. If any PEEK 
information bits are set, QAC creates a block of replies that all have 
the same length. Any words in a particular reply that are not defined 
for the queue type of the reply contain zeros. 


The bits in this word correspond to the octal numbers in the lower 6 bits 


information of words in the peek reply block. Each bit set in this word 


bits 
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causes QAC to return the information shown in the corresponding word of 
the peek reply block. Certain bits select information contained in more 
than one word in the reply block: Bit 14 selects message buffer one for 
the control point area (MS1W), bit 15 selects message buffer two for the 
control point area (MS2W), bit 18 selects dayfile messages, bit 19 
selects the command buffer, bit 21 selects the implicit remote text 
string, and bit 22 selects the explicit remote text string. 


Symbols for these peek information bits are defined in the system OPL 
common deck COMSQAC. ; : 


For each file or job that satisfies the selection criteria specified in the QAC parameter 
block, QAC returns a PEEK reply block to the QAC buffer. Each PEEK reply block has the 


following format. 


59 57 53 47 44 41 35 29 23 17 11 5 0 


destination family 
destination user name 
owner family 


owner user name 


MS2W characters 1—10 


MS2W characters 11-20 


MS2W characters 21-30 


| commands (word len4) | 


{This field has a value of zero if the rest of the word contains all zeros. 
TtThis field has a value of zero if the following word contains all zeros. 
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59 53 47 35 29 23 20 17 14 11 5 0 


eee 
a Sd 
implicit remote text string (characters 1—10) 


implicit remote text string (characters 251—256) 
a es ee 
explicit remote text string (characters 1—10) ; 


oo eee cea 
eee a bar 
in Aa oa 
reserved for installations 33t 


The octal numbers in the lower 6 bits of 
words in the peek reply block correspond to 
the peek information bits in word addrtl6g 
of the parameter block for a PEEK request. 
(See the description for the peek 
information bits field.) 


Field Description 

jsn The job sequence name of the selected job or file. 

ordinal. . The EJT or QFT ordinal of the selected job or file. 

queue | The queue in which the job or file is located. 
Bit(s) Queue 


0 Input queue. 

1 Executing job queue. 
2 Print queue. 

3 Punch queue. 

4 Plot queue. 

5 Wait queue. 


6-7 : Reserved for Control Data. 
8 . Reserved for installations. 
9-11 Reserved for Control Data. 
sc ' The service class of the job or file. For a list of the service 


class values, refer to Service Class Types in appendix E. 
ot The origin type of the job or file. 


TThis field has-a value of zero if the rest of the word contains all zeros. 
tfThis field has a value of zero if the following word contains all zeros. 
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Field 


forms 

disp 

ec 

ic 

priority 
fl-em 

fl-cm 
destination 


family 


destination 
user name 


id 
owner 
family 


owner 
user name 


cid 


Description 


ot Origin Typef 

01 SYOT (system) 

02 BCOT (local batch) 

03 RBOT (remote batch) 
04 IAOT (interactive) 


The forms code for the file. Does not apply to jobs in the 
executing queue or files in the input queue. : 


The disposition code assigned to the file. Does not apply to 
executing jobs. 


The external characteristics of the file. Does not apply to entries 
in the executing queue or the input queue. 


The internal characteristics of the file. Does not apply to entries 
in the executing queue or the input queue. 


The queue priority of a queue file or the CPU priority of an 
executing job at the time the PEEK request took place. 


The current extended memory field length for the job. 
to jobs in the executing queue. 


Applies only 


The current central memory field length for the job. Applies only to 


_jobs in the executing queue. 


The destination family for the file, if the file is not 

routed to a local batch device. This represents the family under 
which you would have to log on to a remote batch terminal in order to 
access the file. A value of zero is entered if the file is routed to 
a local batch device. 


The destination user name for the file, if the file is not 

routed to.a local batch device. This represents the user name under 
which you would have to log on to a remote batch terminal in order to 
access the file. A value of zero is entered if the file is routed to 
a local batch device. 


The destination batch device ID, if the file is routed to a local 
batch device; otherwise, zero. : 


The family that owns the file or job. 


The user name that owns the file or job. 


The device ID of the device at which the file or job was created, if 
it was created at a local batch device; otherwise, zero. 


tOrigin types returned by QAC do not have the same value as those defined in NOSTEXT. 
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Field 


dfo 
destination 
ui 

ofo 

‘owner 

ui 


user job 
name 


pi 


60459690 J 


Description 


The family ordinal corresponding to the destination family. A value 
of zero indicates no family ordinal. 


The user index corresponding to the destination user name. A value 
of zero indicates no user index. : 


The family ordinal corresponding to the owner family. A value of 
zero indicates no family ordinal. 


The user index corresponding to the owner user name. A value of zero 
indicates no user index. 


The user job name associated with the file or job. 


The print train image code for the file. If nonzero, the code is 
biased by 10g, 


8-20.1/8-20.2 


rep 


account 
limit 


esto 


creation 
datet+time 


file 


-length 


creation 
jsn 


ejt stat 


scheduling 


field 


lenl .- 


MS 1W 
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Description 


The spacing code for the entry. Does not apply to jobs in the 
executing queue or files in the input queue. . 


This bit is set if the file is interrupted. Applies only to output 
files. ; 


The repeat count for the entry. Does not apply to jobs in the 
executing queue or files in the input queue. 


The user’s validated resource limit that applies to the type 

of device to which the file or job is routed. A value of 777777772 
is defined as unlimited. Does not apply to jobs in the executing 
queue or files in the input queue. ; 


The EST- ordinal of the device on which the file resides. Does not 
apply to jobs in the executing queue. 


The packed date and time when the file was first queued. The 
six 6-bit octal fields contain the following: year minus 1970, 
month, day, hour, minute, and second. a 


' The length of the file in PRUs. Does not apply to jobs in 


the executing queue. 

The job sequence name of the job that created the file or job. 

The status field of the EJT entry. Applies-only to executing jobs. 
Bits 1 through 5 contain the EJT job status of the job. Bits 7 
through 10 contain the EJT connection status of the job. Refer to. 
appendix E for a listing of valid EJT status codes and their meanings. 


CPU status. Applies only to execut ing jobs. 


Value Description 


Null status. 

A status (job active in CPU 0). 

B status (job active in CPU 1). 

Not used. 

W status (job waiting for CPU). 

X status (job waiting for recall). 
I status (job waiting for PP drop). 
Not used. 


NOUNS WNR OS 


The contents of this field depend on the EJT status of the 
job. Applies only to jobs in the execution queue. Refer to appendix 
E for a description of the scheduling field associated with each EJT 
status code. 


The length of MSIW in words. This field always has a value of five. 
The message in message. buffer 1 of the job’s control point area. The 
message can contain up to 50 characters. If the message is less than 


50 characters long, it is terminated by the standard display coded 
line terminator sequence. 


8-21 


8-22 


Field 


len2 


MS2W 


SRU limit 


SRUs 
accumulated 


alen3 


len3 


dayfile 


' messages 


alen4 


len4 


commands 


dlid 
slid 


clen 


wien 


implicit 
remote text 
string 


explicit 
remote text 
string 


remote 
mainframe 
user 


remote 
mainframe 


family 


ojsn 


Description 
The length of MS2W in words. This field always has a value of three. 
The message in message buffer 2 of the job’s control point area. The 
message can contain up to 30 characters. If the message is less than 
30 characters long, it is terminated by the standard display coded 
line terminator sequence. 
The job’s SRU limit (from the job control point area). 


The current number of SRUs accumulated by the job (from the 
job’s control point area). 


The number of nonzero words in the dayfile message entry. 


The length of the dayfile message entry in words. 
has a value of 114g, 


This field always 
QAC enters a copy of the job’s dayfile buffer. Dayfile 

messages have the standard display coded line format. 

The number of nonzero words in _the commande entry.. 


The length of the commands. in words. 
of 110g, 


This field always has a value 


QAC enters a copy of the job’s command buffer.. Commands already 
executed and commands not yet read into the buffer do not appear. 
Commands have the standard display coded line format. 


Destination logical maCDL ELSES for the file. 
Source igeieed identifier for the file. 


The length of the implicit or explicit remote text string in 
characters. 


The length of the implicit or explicit remote text string in words. 


A string of up to 400g characters that contains parameters for the 
operating system under which the file was created. This string is 
present only for remote host files. 


A string of up to: 400g characters that form a job control command 

in the job control language of the operating system of the mainframe 
that is to process the file. This string is present only for remote 
host files. 


The user name under which you must log on to a remote batch terminal 
to access the file at the destination mainframe. This word is 

present only for remote host files. 

The family name under which you must log on to a remote batch terminal 
to access the file at the destination mainframe. This word is present 


only for remote host files. 


The original job sequence name under which the file was created. 
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Example: 


The following program locates up to 10 executing jobs that were submitted under the 


.Same user’name as the programs All. information about those jobs is stored.in the 


Description - 


The lower access level limit.of the input file or job... 


The upper access level limit of the input file orjob. 


The current access level of the file or job. 


. PEEK reply buffer and is dumped. 


IDENT PEEKJOB 


ENTRY MAIN 

th QAC PARAMETER BLOCK 

BLOCK Bss 0 
VFO «= 59/3,1/0 
VFO 36 /0,6/11,18/RE PLY 
VFD 420, 18/REPLY 
VFO = 42/0, 18 / REPLY 
VED 42, 0, 18/REPLY+1000 
vFD =—s-« 60/0 
vF>D =—«-:« 60/0 
veo} =—s-—« 0/0 
VED  12/2,48/0 
vFD ~=~>s 0/0 
vEeD «=. 60/0 
VFO = 60/0 
VFD 12/0, 12/10, 3670: 
veo = 60/0 
VFD 37/0, 23/-0.. 
vED 60/0 

tek MAIN PROGRAM 

MAIN SYSTEM QAC,R,BLOCK 
SYSTEM -DMD,R,BLOCK+15,BLOCK 
SYSTEM DMD,R, REPLY+1000, REPLY 
ENOR UN 

kk PEEK REPLY BUFFER 

REPLY BSSZ 1001 
END MAIN 
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PEEK FUNCTION CODE 
PEEK REPLY BUFFER, 


? 
oe 
a” 


ae 4 


This program uses the SYSTEM macro (refer to 
section 11) to issue. the QAC request. — ee 


SELECT EXECUTING JOB QUEUE 


SELECT UP TO 10 ENTRIES 


SELECT ALL INFORMATION 


CALL Q@AC * 


DUMP UPDATED PARAMET 


DUMP. PEEK REPLY BUFFER 


REPLY BUFFER 


ER BLOCK © 
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: .  SYSTEMTIME/DATEREQUESTS. 


NOS provides several system requests associated with the time and. date. These requests are 
processed directly by CPUMTR. Unless otherwise noted, the only common deck required for 
absolute assemblies is COMCSYS. : ; 


The format of the RAtl call to the time function processor is: 


59 40 35 — 23 17 os O. 
AZ Vj cae 
R Auto recall bit. a ais fm te 
. code Function code as follows: Sh é 
Code _ Macro Description 
0000 TIME Accumulated CP time used by the job. 
00e1 DATE -—- Current date in display code. 
90002 - CLOCK Current time of day in display. code. * 
0003° JDATE Current Julian date.. 
0005 . -RTIME Elapsed real time since last deadstart. 
0006. PDATE Current date and time in packed binary form. 
0007 STIME Accumulated system resource units. - a 
0011 HTIME Accumulated clock cycle count for control point. 
0012 . HTIME Accumulated clock cycle count since deadstart. | 
addr. Address of a. reserved one-word block that will receive the reply. 


‘ 


. The EDATE and ETIME macros described in this section do not have an RAtl call. They are’ 
processed by common. deck COMCEDT and are used to convert | ‘the format oS a date and ‘time ; 
returned by a previous macro call. 
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CLOCK 


In response to the CLOCK function, the: system returns the current time of day in display 
code to location addr. : : 


Macro format: 


- Location. Operation . Variable 
CLOCK addr 
addr Address of reply word. 


Reply word format (display code): ee gee ae 


59 53 4 35 23 7 ] ie] 
ear { Spo ff em Te 


A Space (display code 55g). 


hh Hours. 
mm Minutes. ; aE , ® 
ss Seconds. . . : “fy 


DATE 


In response to the DATE function, the system returns the current date in display code format - 
to location addr. : 


Macro format: 


Location Operation Variable » 2 - ] 
DATE addr 
addr © Address of reply word. 


Reply word format (display code): 


59 53 41 35 23 17 5 ce) 
oer} OP ow Tet mm TT oe Td 


A Space (display code 55g). 

yy Year (last two digits). 

mm Month. @ 

dd Day. is 
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EDATE 


-EDATE- converts the packed date in address pdate to pies le code and. enters the converted 


date in register X6. 


Macro format :f 


Location Operation .. Variable 
EDATE | pdate 
pdate “Register or  saarene containing packed date to. be converted. 


Format of address’ or: register: containing packed date: 


‘ 


59 Ee ee (ee | ee 
a a 
yy Year minus 1970. 
mm Month. 
dd Day. 


3 . a ido 


Upon completion, register X6 contains the following (display code): 


Space (display code 55g). 


a 

yy: Year (last two digits). 
mm Month. : ae os 
‘ ; 


Day. eae 


This macro requires the common decks COMCEDT and eaecm. 


tThis macro is not available in SYSTEXT., The user: program must specify ‘systems text 
PSSTEXT or call common deck - ‘COMCMAC - (refer to appendix F). wt ode x 
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ETIME 


ETIME converts the packed time in address ptime to display code and enters the eCnvErred, 
time in register X6. 


Macro format:f 


Location Operation Variable 5 
ETIME ptime : 
ptime mee teter or address sonteie. packed time to be > converted. 


Ye 


Format of address or festeter containing packed time: 


hh Hours. 
mn Minutes. 
ss . Seconds. 


Upon completion, register X6 contains the following (display code): 


. as es eas . BR 


ee 4.35 | SO 
i et ed Pe a ee Se 


A Space (display code 55g). 
hh Hours. 

mm Minutes. 

Ss Seconds. 


This macro requires the common decks COMCEDT and COMCCDD. 


{This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix -F). 
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‘ % @ 


HT! 


ME 


HTIME returns the model 176 accumulated CPU clock cycle count (if available) either for the - 
current job or since the last system deadstart. A clock cycle on the model 176.is 27.5. 
nanoseconds. : ; 


Macro format: 


Location. Operation . Variable 
HTIME addr ,op 
addr Address of reply word. 
op ' Option desired; if 0, accumulated. clock cycle count for the current job 


is returned (function code 11); if 1, accumulated clock cycle count 
since the last. system-deadstart is. returned (function code.12). . 


Reply word format: 


59 47 = ’ 0 


addr [te CPU clock cycle count a oo —_ 


type If the model 176 CPU clock cycle count is available, type is 2000. 
— If the model 176 CPU clock cycle count is not available, type is 6000g. 


JDATE 


JDATE returns the current Julian date, in display code, to location addr. oe ae 


Macro format: 


Reply word format (display code): 
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Location . Operation Variable 
JDATE . addr ae > 
addr Address of reply word... 


yy Julian year. 
ddd. Julian day. 
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PDATE 


PDATE returns the current date. and time in binary packed format.. The user program can 
unpack the parameters or use the EDATE and ETIME macros to do the unpacking. 


Macro format: 


Location Operation Variable 
PDATE addr 
addr Address of reply word. 


Reply word format: 


' §9 —_-° 35 29 23. 17! 1. 5: ce] 
Te 
yy Year minus 1970. | 
mo Month. 
dd Day. 
hh Hours. 
mam a >. Minutes. 
88 Seconds. 
RTIME 
RTIME returns the real-time clock reading to location addr. This is the elapsed time since 
deadstart. 


Macro format: 


Location’ »: . Operation Variable A : 
RTIME addr 
addr Address of reply word. 


Reply word format: 


~ 


i e a ae 7% . 4 
seconds Time since deadstart in seconds. 


milliseconds - Time since deadstart in milliseconds. 
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STIME oe 


“STIME returns the job”s accumulated system resource units ‘(SRUs). Refer to the NOS 2. 
Analysis Handbook for a description of SRUs. ; : . : 


Macro format: 


Location Operation = Variable 
STIME addr 
addr Address of reply word. 


Reply word format: 


milliunits Accumulated system resource units/1000. 


TIME 
TIME returns the accumulated central processor time used by the job to location addr. 


Macro format: 


location - Operation Variable 
TIME addr 
addr Address of reply word. 


& 


Reply word format: 


59 47 35 11 {°] 


seconds _ Accumulated central processor time in: seconds. 


milliseconds. Accumulated central BEE ner time in milliseconds 


(modulo 1000). 


In order to use the values returned by the 
- TIME macro to. determine total accumulated 

central processor time, the user program 

must perform the following conversion: 


Total time (milliseconds) = (seconds x 
1000) + milliseconds. ; 
’_... Attempting to use bits 35 through Oasa 
'. gingle quantity will produce meaningless: 
results. 
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a —ee 


TRANSLATE CONTROL STATEMENT 


Translate control statement (TCS) processes user requests to read a command from or to place 
a command into the stream. . The only common deck required for absolute assembly is COMCSYS. 


The format of the RA+l call is: 


59 


a Ag i 40 35 23 17 
i) ees 7” 7/77, Oe 


code 


sf 


addr 
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io) 


- Auto recall bit. 


Function code: 


Code Macro 
004 CONTROL 
005 EXCST 


Subfunction code for the CONTROL macro. This field is not used for the 


EXCST macro. 


sf Action 


00 Read the next command and advance the command pointer. 

Ql - Read the next command only if it does not call for a load from a 
local file or from a global library set. Do not advance the 
command pointer. 

02 Read the next command even if it calls for a load from a local 
file or from a global library set. Do not advance the command 
pointer. 

4x If the next command being read should be processed in product 
set format, sf should be set to 4x, where x can be 0, 1, or 2, 
corresponding to one of the above options. If sf is not set to 
4x, command parameters are to be processed in NOS format. 


First word address of the buffer in which the command is to be stored .or 
from which the command is to be read. 


CONTROL (004) 


The CONTROL macro allows the user program to read the next command in the command stream and 
transfer it to a specific address. The command is checked for syntax errors, and all 
parameters are stored as if a program was actually loaded. 


If no command exists or if SHELL program processing is in effect, binary zero words are 
returned to the buffer. If the next command is of the form: 


*comments 


the command is returned to the buffer if the comments string ends with a period or right 
parenthesis. Otherwise, the binary zero words are returned to the buffer. 


Macro format: 


Location Operation Variable 
CONTROL addr,rss,lf,psf 
addr First word address of the buffer in which-the next command is to be 


stored. The user program should allow room for eight words (80 
characters). 


rss If rss is specified (any value may be used), the command pointer is not 
advanced. This allows the user program to determine what the next 
command is and still allow it to be processed. If rss is not specified, 
the command pointer is advanced as if the command had been processed. 


lf If rss is not specified, 1f is ignored. If the following are true: 
e rss is specified, 
e 1f is not specified, 


e the command to be read calls for a load from a local file or 
from a global library set, 


the command is not read. If rss and 1f are both specified (any value 
may be used for 1f), the command is always read. If the command calls 
for a load from a local file or from a global library set, bit 17 or 
RA+64g is set. 


psf If psf is specified (any value may be used), parameters are unpacked in 
. product set format. 
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The command parameters are stored in the job communication area (refer to figure E-1) 
beginning at ARGR (RA+2) through RAtn (n cannot exceed 63g), These parameters are _ 
terminated by a zero word. The number of parameters stored in the job communication area is 
placed in the lower 18 bits of ACTR (RA+64g), The name of the command is placed in bits 

59 through 18 of PGNR (RA+64g). The parameters are stored in either operating system or 
product set format, depending on psf. The command image, less any label or prefix field, is 
stored beginning at addr. : 


If the parameters are stored in operating system format, the comma, period, and right 
parenthesis are stored as zero. For all parameters and valid separators except the comma, 
their display code. equivalent is stored. 


If the parameters are stored in product set format, separators and terminators are stored as 
follows: 
Character ’ Code (Octal) 
4 ‘2 4 
= 2 
[i 3 
( 4 
+ 5 
a 6 
A , 10 
_)or. 17 
Others . 16 


The manner in which CONTROL stores the command is identical to the way the system normally 
processes commands, except that the command image is stored at the specified address. When 


the system processes a command, the command image is stored beginning at CCDR (RA+/0g). 
Calling the CONTROL macro does not affect the contents of CCDR. 


Example: 


The following program reads the next command in the command stream (advancing the 
command pointer), stores the parameters in operating system format, and transfers the 
command image to the specified buffer. 


IDENT | CMND 

ENTRY CMND 
CMBUF _BSS 8 - : | 
CMND CONTROL CMBUF 


SYSTEM DMD,R,63B,2 
SYSTEM DMD,R, CMBUFS7, CMBUF 
ENDRUN 


END CMND 
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When the program is executed from a batch job or in a procedure file and is followed in 


the command stream by: 


TEST, A=B,C=D,E, F. 


the contents of central memory are displayed as follows: 


ARGR ~——- RA+2 0100 


+3 0200 
+4 0300 
+5 0400 
+6 0500 
+7 0600 
+10 0000 
CMBUF #0 2405 
+1 5404 


0000 
0000 
0000 
0000 
0000 
0000 


0000 


2324 
5605 


If the macro call is changed to 


CONTROL CMBUF,,, PSF 


0000 
0000 
0000 
0000 
0000 
0000 


0000 


5601 


5606 


0000 
0000 
0000 
0000 
0000 
0000 
0000 


5402 
5700 


the command parameters are stored in product set 
RA+2 through RA+10g appear as follows: 


ARGR RA+2 0100 


+3 0200 
+h 0300 
+5 0400 
+6 0500 
+7 0600 
+10 0000 


0000 
0000 
0000 
0000 
0000 
0000 


0000 


0000 
0000 
0000 
0000 
0000 
0000 


0000 


0000 
0000 


0000 


0000 
0000 
0000 


0000 


0054 
0000 
0054 
0000 
0000 
0000 


0000 


5603 
0000 


format and 


0002 
0001 
0002 
0001 
0001 
0017 


0000 


TEST ,A=B,C 


=D,E,F. 


the contents of locations 


A B 
B A 
C B 
D A 
E A 
F 0 
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EXCST (005) 


With the EXCST macro the user program specifies a buffer containing a command. Control is 
transferred from the calling program to the system, which reads the command, places it in. 
the command stream, and processes it. Control is not returned to the calling program. The 
command must conform to NOS command format conventions described in Volume 3, System 
Commands. 


Macro format:f - 


Location Operation Variable 


EXCST : addr . 
addr - First word address of the buffer containing the command to be processed. 


The system begins reading at addr and continues until the end of 
statement (zero byte) or end of buffer (80 characters) is reached. The 
command must be left-justified with zero fill. 


- CHECKPOINT/RESTART 


A job may be.terminated at any time as the result of system, operator, or program error. For 
some jobs it becomes more advantageous to accept the overhead of checkpoint procedures than 
to run the risk of losing the entire job output. The checkpoint/restart feature is 
implemented through the CKP command or CHECKPT macro and the RESTART command. Refer to 
Volume 3, System Commands, for discussions of’ the CKP and RESTART commands. . 


CHECKPT 


The CHECKPT macro is used for taking checkpoint dumps. The dump is written on the tape or 


mass storage checkpoint file specified on a REQUEST, ASSIGN, or LABEL command or REQUEST or 


LABEL macro. For a general description of checkpoint dumps, refer to Volume 3, System 
Commands. The CHECKPT macro provides you with greater control than the CKP command in 
specifying the type of copy to be performed. : 


« € 


[Nore] 


A checkpoint is not allowed in a program 
that has issued a PROTECT macro selecting 
user file privacy, in a program that has 
issued a SETSSM macro, or in a program that 
has been loaded from an execute-only file. 


¥ 


TThis macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). ; : 
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Macro format: 


Location Operation Variable 
CHECKPT addr,sp 

‘addr Address of the parameter list identifying the files to be checkpointed. 

sp - Flag indicating whether or not all files assigned to the job are to be 


checkpointed. If sp is specified (any value may be used), only those 
files: specified in the parameter block at address addr will be 


checkpointed. If the sp field is not specified, all local files will be 
checkpointed. 


The format of the RA+tl1 call is: 


R _ Auto recall bit. 


sp .Flag indicating whether or not all files assigned to the job are to be 
checkpointed. If sp is specified (any value may. be used), only those 
files specified in the parameter block at address addr will be 
checkpointed. If the sp field is not specified, all local files will be 
checkpointed. 


‘addr Address of the parameter block identifying the files to be checkpointed. 
Parameter list format: 


59 


ee 
. ——— 7 


e e “ e 
e 6 _ 
ot dH 
cn . Latest checkpoint number. 
n- Octal number of entries in the parameter list (O<n<77g). 


{This macro is not available in SYSTEXT. The user program must specify. systems text PSSTEXT 
-or call common deck COMCMAC (refer to appendix F). 
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lfny 


Identifies file to be checkpointed; lfni is left-justified. 


Specifies the manner in which lfny is to be copied: 


fy 


0 


Description 


The mass storage file is copied from the BOI to its position 
at checkpoint; only that portion is available for restart. 
RESTART positions the file at the latter point. 

The mass storage file is copied from its position at 
checkpoint.to the EOI; only that portion is available for 
restart. RESTART positions the file at the former point. 
The entire mass storage file is copied. RESTART sets the 
file to its position at checkpoint time. © 


The last operation on the file determines how the mass 


storage file is copied.. 


Last Operation £ Selected 
Write £4=0 
Read (EOI detected) No copy 
Read (EOI not detected) f£4=2 


The information table associated with the file is copied but 
the file itself is not copied. The information table 
contains FNI/FST information and the random address of the 
mass storage file or the block count of the magnetic tape 
file. RESTART retrieves the file in some cases (refer to 
RESTART) and sets it to its position at checkpoint time. If 
f£i=4 and the file is a mass storage file, RESTART assumes 

it is an indirect access file and issues a GET macro to 
obtain a working copy. 


If a value other than 4 is specified for a magnetic tape file, a warning 


message is issued and the file is processed as if fy =4 had. been 
specified. 


fy =4 is also forced for execute-only files. 


The following list shows the type of operation CHECKPT performs for the different values of 


sp and n. 
sp Ls 
any 0 
) # 0 
#0 #0 
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Operation 


All files assigned to the job at checkpoint time are processed according 


to the last operation performed. 


All files assigned to the job at checkpoint time are processed. The n 


files included in the parameter list are processed according to their 
respective f values. All other files are processed according to the. 
last operation performed. a3 


The n files specified in the parameter list are processed according to 
their respective f values. 
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The procedure scratch files ZZZZZCO, ZZZZZC1, and ZZZZZC2 are always checkpointed; they are - 


copied from BOI to EOI (refer to fj =2), regardless of the sp and n values. - 


' The INPUT, OUTPUT, PUNCH, PUNCHB, P8, and LGO files, and procedure data files ZZCCLAA 
through ZZCCLZZ are always checkpointed; they are copied according to the last operation 


performed (refer to f;=3), regardless of the sp and n values. 


For all other files except direct access files, the default copy type is f=4 when n#0. 
.For direct access files, the type of copy CHECKPT makes depends on the access mode. 


Mode : User Option ' Default 

W- Write Any type of copy Copied (f=3) 

R Read-only a3 Any type of copy Not copied (f=4) 

E- Execute-only ‘Only f=4 Not copied (f=4) 

A Append-only Any type of copy Copied (f=3) 

M- Modify Any type of copy Copied (f=3) 

RA Read/allow append Any type of copy Copied (f=3) 

RM Read/allow modify Any type of copy Copied (f=3) 

U Update Any type of copy Copied (f=3) 

RU Read/allow update Any type of copy Copied (f=3) 


For a random file the copy type must be f=2 or it will be copied according to the last. 


operation performed (f=3). 


If f=4 is selected, you may have to retrieve the file yourself at restart time and select 


the NA and FC options on the RESTART command (refer to Volume 3, System Commands). 


REPRIEVE PROCESSING 


correct the problem. 


The format of the call to RPV is as follows: 


59 40 17 ie) 
% 
a+ rev Rar 
R Auto recall bit. 
addr First word address of the parameter block. 


RPV supports the following functions. 


© SETUP 
o RESUME 
oe IRESUME 
e RESET 
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Reprieve processing (routine RPV) enables the user program to intercept interrupts prior to 
an abort of the program and to take corrective action. This action can be the completion of 
files (such as flushing buffers or closing files) and tables or it can be an attempt to 
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The SETUP function is used to initialize the parameters for the RPV interface (that is 


‘setting the mask bits that indicate which errors aré to be intercepted). It also initializes 


all RPV data in the jobs control point area; if the parameter block indicates pending’ 
interrupts or I/0 requests, they are processed at that time. 


The interrupt handler is that portion of your program that processes interrupts. When an 
error occurs, the system will interrupt your program and restart it at the address that was 
specified in the RPV block. At this point, your program is running in interrupt handler - 
mode which will prevent further errors from interrupting the program until the program has 
completed processing the first error. 


The resume functions are ‘used ‘to restart the program after an interrupt has been processed. 
Any pending interrupts that occurred during the processing of the previous interrupt are : 
detected then and the interrupt handler is restarted to process these interrupts. 


‘Optionally, the mask bits can also be changed during a resume function. Two modes of resume 


are allowed: program mode and interrupt handler mode. 


If the interrupt being processed is a CPU 
error exit, a resume function is not possible 
without manipulation of the exchange package 
and, in most cases, is not practical even 
with such manipulation. 


‘The program mode resume (RESUME) will cause the system to restart the program at the 


interrupt point. The interrupt handler mode will be cleared so that any additional errors 
will cause a new interrupt of the program. Also, any errors which occurred og interrupt 
handler mode procesesng will cause a new interrupt at this time. 


The inceepave handler mode resume (IRESUME) will cause the system to restart the program at 
the point of interrupt, but without clearing the interrupt handler mode. This allows the 
program to complete the task it was engaged in before the interrupt, and to then process the 


‘error and terminate the program at some later time. 


Further interrupts will be inhibited after 
the IRESUME is processed. Normal processing 
may be resumed by issuing another REPRIEVE 
SETUP. 


The RESET function is used to reset a previous error flag and allow the operating system 
error handling routines to process the error. That is, the mask bits are cleared to disable 
further reprieve processing and the system processes the error as if the appropriate mask 
bit had not been set. Pending interrupts are not processed; however, any pending RAt+1l 
request is reset and the exchange package is reset from the reprieve parameter block. 
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| 
| RPVBLK 
| 

The RPVBLK macro creates a REPRIEVE parameter block. 


Macro format:T 


Location Operation Variable 


| tag RP VBLK xfer ,xjp ,chklwa 

tag Symbol for address of parameter block. 
xfer Address of error processing routine (transfer address). 
xjp Symbol for address of exchange package within parameter block (optional). : & 
chklwa Checksum last word address (optional). 


{This macro is not available in SYSTEXT. The user. prog ram must specify systems text 
’ PSSTEXT or call common deck COMCCMD (refer to appendix F). This macro requires common 
deck COMSRPV. 
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The format of the parameter block is as follows: 


35 29 23 ; n9 te) 


___tronateraséress 


: error class error code . 


pending RA+1 request 
interrupted terminal 1/0 


reserved error flag 


exchange package 


length 


func 


c 
checksum 
lwa 
transfer 
address 


-checksum 
value 
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Length of the parameter block including the exchange package 


area (minimum of 3lg words). 
Function code: 


SETUP. 

Program mode resume (RESUME). 

RESET. 

EOESETUPE handler mode resume (IRESUME). 


FwWnNe 


Completion bit (set ce RPV when eperet ion is complete): 


Specified by the user to indicate the end of the area to be 
checksummed and compared or set. If zero, no checksum is 


desired (checksum area begins at transfer address). 


Address to which control is CEBUA EER TES when an es a ‘is 


processed. 


Either set to the checksum of the indicated area when RPV is 


called, or compared against the computed checksum (if 
checksum lwa is apectttcd) when a reprievable error is’ 
processed. 
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mask Indicates which types of interrupts are to be intercepted so 
that they may be processed in the program. If a particular 
bit is set in the mask, the corresponding error class will 
be intercepted; if a bit is clear in the mask, the 
corresponding error class will be processed by the system. 
If mask=0, extended reprieve processing is cleared. 


mask Error Class 
001 CPU error exit .t 
002 PP call error. 
004 SRU limit. 
010 Operator termination ft 
020 PP abort. 
040 _CPU abort. 
100 Normal termination. 
200 Terminal interrupt .tfT 
error classtftf Set to the value of the mask bit which intercepts the 


indicated error (that is, if error x is intercepted by mask 
bit n, then bit n in the error class field is set). Refer 
to table 10-1 for a list of error classes. 


error codetttt Octal code indicating error encountered. Refer to table 10-1 
for a list of error codes and their meanings. - 
pend ing : Used to queue pending interrupts (that is, the nth error code 
interrupts sets bit n in this field). 
‘pending RA+1 Contents of RAtl:at time of interrupt. RA+tl is reset from 
requestttTtit this field on a resume or reset call. 
interrupted Contains interrupted input request if an interrupt: occurs 
terminal 1/OTTTTf while a terminal input request is pending. The format is as 
follows: 
59 7 35 17 ny) 
ee 
error flagtttt Value of the operating system error flag at the. time of the 


interrupt (refer to appendix E for a list of error flags). 


TThe MODE macro, described in section 6, can be used to specify which types of 
arithmetic operations will cause this error to be detected. 
TTNOS will allow a job to reprieve an operator KILL only once; the second time the 
operator KILLs the job, no reprieve processing will occur. 
TRefer to Control of Program Execution in section 12 for a description of the meEnods 
by which you can interrupt a program from a terminal. 

Tift Because the binary values of the error flags are subject to change in Fiesaaent 
releases of NOS, you are encouraged to use the error class and error code fields for 
checking error status rather than the error flag field. 

TtTTT Lf this field is nonzero, the FET involved has been left in a busy state. If the 
program wishes to use this FET within the interrupt handler (prior to doing a 


REPRIEVE RESUME), it is the program's responsibility to set the FET complete before 
trying to use it. 
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reserved 
inst. 


_ exchange - 


package 


This area. is reserved for use by the installation. 


A copy of the exchange package at the time of the interrupt 
(unchanged from the executing package at the time of the 
error). This is the exchange package that is used when the 
interrupt handler is started. 


Table 10-1 lists the return information for RPV error codes, classes, and flags. 
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Table 10-1.. RPV Error: Codes, Classes, and Flags 
Error. | ‘ Corres pond ing 
Code(s) Description : Error Flags 
Normal termination 
Time limit 
CPU error exitt 


PP abort, SCP invalid 
transfer address 


CPU abort 
PP call error 
Operator drop 


Operator kill 


Operator rerun RRET 
Command error None 
Extended memory parity error ECET 
Auto recall: error None 


Job hung in auto recall RCET 


Mass storage/service limits FLET, TKET, SLET 


PP program not in library None 

I/O limits SRET 

Reserved for installations None 

Terminal interrupttt TIET, TAET 
Reserved for installations None 

Reserved for installations None 

N/A DRET, TJET, RAET 


TThe MODE macro, described in section 6, can be used to specify which types of arithmetic 
operations will cause this error to be detected. 


Tt Refer to Control of Program Execution in section 12 for a description of the methods by 
which you can interrupt a program from a terminal. 


Refer to appendix E for a complete list of error flags and descriptions. 


10-14 60459690 D 


REPRIEVE 


The REPRIEVE macro provides access to the extended reprieve processing capabiiities of RPV. 
REPRIEVE parameters are inserted into the designated positions in the parameter block. 
Other fields are the responsibility of the caller. 


An error will occur if a REPRIEVE macro is 
issued while either DISTC or EREXIT is in 
effect (DISTC processing is described in 
section 11 of this manual; EREXIT processing 
is described in section 6). 


Macro format: 


Location , Operation Variable 
REPRIEVE addr, type, mask 
addr Address of the parameter block. 
type. Type of call: SETUP, RESET, RESUME (program mode), or IRESUME (interrupt 


handler mode). 
mask Desired mask setting. 
The REPRIEVE macro issues the RA+l request without using common deck COMCSYS, since that 
routine is not reentrant and the interrupt could have occurred there. The interrupt handler 


should not access any other portions of the program which are not reentrant or are shared 
with noninterrupt handler code. 


TThis macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix F). 
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One way to avoid this problem is to qualify those macro calls in the interrupt handler that 
| use COMCSYS to issue the requests, and also provide a qualified copy of COMCSYS to ensure 
that no conflict exists. The following example illustrates this process with the MESSAGE 


macro. 
Interrupt handler code 
QUAL —IHX 
| MESSAGE ERR1,3 
QUAL * 
ERR1 DATA C*xSOME ERROR* 
QUAL THX 
QUALS SET 0 FORCE UNQUALIFIED COMMON DECKS 
OPL XTE XT COMCSYS 
QUAL * 


Appendix M contains an illustration of extended reprieve processing. 
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SYSTEM/LOADER REQUESTS V1 


SYSTEM REQUESTS 


The following requests perform miscellaneous tasks associated with a job. Most of the 
requests are processed by the system monitor directly rather than by a specific function 
processor. The calling format is shown for each macro. Unless otherwise noted, the only 
common deck required for absolute assemblies is COMCSYS. 


ABORT 


A user program can abort itself when a program error occurs by using the ABORT macro. If 
the job or the current procedure contains an EXIT command, the system continues job 


' processing with the command that immediately follows the EXIT command. This process can be 


altered either by reprieve processing (refer to section 10) or by using the NOEXIT command 
(refer to Volume 3, System Commands). 


Macro format: 


‘Location Operation - Variable 


ABORT 


The format of the RA+t1l call for this function is: 


59 Oo 


DAYFILE 


The DAYFILE macro enables the user program to access the job dayfile. A FET of at least 
seven words must be specified. , ‘ 


A portion of the dayfile resides in the system central memory buffers. This is transferred 
to the buffer in the job’s field length specified by the FET pointers FIRST and LIMIT. You 
must ensure that the buffer specified is large enough to accommodate the central memory 
portion of the dayfile. The released size is 1149; if the value is different at your 

site, you should contact your site personnel to determine what it is. 


That portion of the dayfile that resides on mass storage is made available to the user 
program as a library file assigned to the job in read-only mode. If a local file with the 
same name as the file name specified already exists, it is returned. The file is positioned 
at BOL. 


60459690 D . 11-1 


This macro requires common decks COMCSFM and COMSSFM for both relocatable and absolute 
assemblies amd also requires common deck COMCSYS for absolute assemblies. 


Macro format :t 


Location Operation Variable 
DAYF ILE addr ,t ype 
addr Address of the FET for the call; name given to the mass storage portion 


of the file. 


type USER (function 0005); attach dayfile. This is the dayfile of the job 
currently running. 


The DAYFILE macro issues the following request to the function processor SFM. 
59 40 35 23 17 d 0 
ZAG 
ds A  % | /7 
R Auto recall bit (required). 
id File identification number. 
addr Address of the FET for the file. 
The format of the FET used by SFM is: 


59 47 44 23 17 . O° 


ee nn 7, 
Zi 70, ee 
ae ane an Ce ee 


FET +0 
+14 
+2 
+3 


serene ey reeeeenn (ae Se 
: Eo pe pet NN yy | 
MOL LLIIIILZ- I]| //0'' 
MPCZcckchkrDPMP HO FF 
” LLL 


fThe macro is not available in SYSTEXT. The user program must specify system text PSSTEXT 


or 
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call common deck COMCMAC (refer to appendix F). 
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1fn 


dt 


ep 
len 
first 


in 


out 


limit 


Local file name of the file to which the job dayfile is to be returned. 


Device type of the device on which the- local file resides (refer to 
Equipment Codes in appendix E). . ; 


Error processing bit (refer to FET Description in section 2). 
Specifies the length of the FET beyond five words. 
First word address of input/output buffer (FIRST address). 


The next available location for entering data into the buffer (IN 
address). H&S 


The next available location for removing data from the buffer (OUT 
address). 


Last word address of the buffer plus 1: (LIMIT address). 


The IN and OUT FET pointers are updated after this request to indicate the presence of data 


in the buffer. 
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SCR 


0 
OUTPUT 


WOCT 


ae 


DAYF 


DAY3 


DAYS 


kk 
OPL 
ak 
IBUF 
OBUF 


CBUF 
WBUF 
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IDENT DAYF 
ENTRY DAYF 
SYSCOM 81 
XTEXT COMSSFM 


ASSEMBLY CONSTANTS. 


EQU 4008 CM BUFFER LENGTH 
EQU 3018 OAYFILE/OUTPUT BUFFER LENGTH 
EQU 3008 WORKING BUFFER LENGTH 


FETS AND CONSTANTS. 


Bss OO DAYFILE 
FILEB IBUF,BUFL,FET=7 


sss 0 OUTPUT 
FILEB OBUF,BUFL,FET=7 


DATA 0 WORD COUNT OF CM BUFFER 
MAIN PROGRAM, 


$B1 1 
DAYFILE I,USER 


SAVE CM BUFFER PORTION OF DAYFILE. 


SA1 I+1 COMPUTE CM BUFFER WORD COUNT 
SA2 A1+1 

sx1 x1 

1x6 X2-X1 

ZR X6,DAY1 IF CM BUFFER EMPTY 

SA6 WOCT 


READW I,CBUF,X6 READ CM BUFFER 
TRANSFER MASS STORAGE PORTION OF DAYFILE. 


READ x INITIATE FILE READ 


READW °1,WBUF ,WBUFL 

NZ X1,DAY3. IF TRANSFER COMPLETE 
WRITEW 0O,WBUF ,WBUFL CONTINUE TRANSFER 

EQ DAY2 

SX2 B6-WBUF SET WORDS TRANSFERRED 
ZR X2,DAY4 IF NONE 


WRITEW O,WBUF,X2 EMPTY BUFFER 


WRITE CM BUFFER PORTION OF DAYFILE. 


SA2 WOCT GET CM BUFFER WORD COUNT 
ZR X2,DAY5 IF CM BUFFER EMPTY 
WRITEW 0,CBUF,X2 WRITE CM BUFFER 

WRITER 0 

RETURN I 

ENDRUN 


COMMON DECKS. 


XTEXT COMCSFM 


BUFFERS. 

BSS BUFL DAYFILE BUFFER 
BSS BUFL OUTPUT BUFFER 

BSS CBUFL - CM BUFFER 

BSS WBUFL WORKING BUFFER 
END DAYF 


The following example reads the user dayfile and writes it to OUTEUE (assembly of this 
program requires that the system OPL be attached to the job). 
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ENDRUN 


The ENDRUN macro requests normal termination of a program. The system begins execution with 
the next command, if there is one. If there are no more commands or if the next command is 
an EXIT command, the system terminates the job. This process can be altered. by reprieve 
processing (refer to section 10). ‘ 


Macro format: 


Location Operation - Variable 
ENDRUN 


The format of the RA+l call for this: function is: 


GETLIDA 
The GETLIDA macro allows the user program to obtain the various attributes for a specified 
LID. Common decks COMSSFM and COMCSFM are required for absolute and relocatable assemblies. 


Macro format :f 


Location Operation Variable 


GETLIDA addr 
addr Address to receive attributes of specified LID. 


The format for the RAt+tl call for this function is: 
59 3635 2423 1817 


The format of addr word (before the call to COMCSFM) is: 


59 4241 0 
lid User-specified lid. 


TThis macro is not available in SYSTEXT. ‘The user program must specify systems text PSSTEXT 
or call common deck COMCCMD (refer to appendix F). . 
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The attributes of the lid are returned in the following format: 
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attr 


rfu 


nw 


re 


59 4241 


User-specified lid. 


3029 2423 20 1817 10 


we[_ = | [eo [w[m[=] | 


lid 


lid attributes (zero if lid not found). 


Bit(s) 

4l Set 
40 Set 
39 Set 
38 Set 
37 Set 
36. Set i 
35 Set 


if 


Description 


host lid. 

linked lid. 

lid is enabled. ; 
prevalidation is required for lid. 

store and forward lid on host. 

store and forward lid on linked mainframe. 
loopback lid on host. 


34-32 Reserved for CDC. 
31-30 Reserved for installation. 


Reserved for CDC. 


Network enabled flags. 


Bit(s) Description 

20 Set if Scope 2 station is in service. 

19 Set if Remote Host Facility is in service. 
18 Set if Network Host Products is in service. 


SFM response code (zero if normal termination). 
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GETMC 


The GETMC macro allows the user program to obtain information about machine characteristics 
and the system environment. Common deck COMCCVL is required for absolute and relocatable 
assemblies. : : ; 


Macro format :f 


location Operation Variable 
GETMC , addr 
@& addr ‘ Address to receive machine characteristics. 


The format of the RA+l call for. this function is: 
59 ; 35 _ 17 (e] 


: {This macro is not available in SYSTEXT. The user program must specify ayerene text PSSTEXT 
: or call common deck COMCMAC (refer to appendix F). 
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The machine characteristics are returned in the following format. 


59 47 35 23 1 __0 
Z aes a ae 
nll O00 | em el 
cs If bit 48 is set, system is operating in 64-character set mode. 
If bit 48 is clear, system is operating in 63-character set mode. 
\ 
en Extended memory size/1000g, 
pp Number of PPs in system. 
me . Machine characteristics. 
Bit(s) Description 
23-22 Unused. 
21 Set if extended memory is in ESM mode. 
20.. Set if machine is a CYBER 180-class model or models 865 
or 875. 
me 19-18 Nonzero if CPU is a model 176; zero if CPU is not a 
model 176. 
17 2x PP speed. 
16 Set if machine is CYBER 170, except CYBER 180-class 
models. 
15 Set if compare move unit (CMU) option is present. 
- 14 Always set to indicate that CEJ/MEJ instruction is 
available. 
13 Set if CPUO has instruction stack. 
12 Set if CPUl is present. 
cm Central memory size/200g (set to 3777g if central memor y>262K). 
c Completion bit (set when operation complete). 


GETSSM 


The GETSSM macro allows the user program. to determine if the system is running in a secured 
mode. 


Macro format :T 


Location Operation Variable | 
GETSSM © addr 
addr Address to receive system security mode. 


}This macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
or call common-deck COMCMAC (refer to appendix F). 
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The system security mode is returned as follows: 


_ 59 : 11 0 
a 
ssm Description .. 
0 If System is in unsecured mode. 
1 If System is in secured mode. 


MEMORY 


The MEMORY macro enables you to determine or change the amount of central memory or extended 
memory associated with your job or determine the maximum amount of memory you can request. 


Macro format: 


Location Operation ' Variable 
MEMORY _ type,stat,R,fl,na 
type — - CM or null for central memory; either is legal. ECS for extended memory. 
stat Status word address. May be omitted only if the fl parameter is 


specified and na is null. 
R Auto recall bit. 


f1 Desired new field length which, if specified, overrides the stat word. 
If fl is specified, the MEMORY macro sets the upper 30 bits of the stat 
word to the value of fl. A negative value may not be used for fl. 


If the value of fl is greater than 3777778, the value must be passed 
to the MEMORY macro in an X register. 


na If null, the program is aborted if the request exceeds the current 
maximum which you are allowed. If this parameter is specified, the 
program is not aborted if the request exceeds the current maximum. 
Instead, the macro does not change the field length, and sets the stat 
word as defined below. 


The format of stat word (if used) is: 
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val Prior to the macro call, val is used to specify the desired new field 
length (words parameter can override this value). If val (or fl) is +0, 
then the current field length for the specified type is returned in this 
field. If bit 47 of val is set and.specified type is CM, and memory 
reduction is honored even if no reduce has been selected (that is, no 
reduce override is in effect).f If val is -1, then the current maximum 
field length for the specified type is returned; if user ECS is disabled 
or not present, a value of zero is returned in val, regardless of any 
validated extended memory field length. If val (or fl) is greater than 
zero for the macro call, it contains the actual value assigned upon 
return. If val is -O and type is extended memory, the field length is 


set to 0. 
rs These bits are reserved for system usage. 
c Completion bit. The system sets this bit when the request is complete. 


If a request is given for an amount greater than the current maximum field length (refer to 
the NOS 2 Installation Handbook for a description of the current maximum field length) and 

if na is specified, then no field length change occurs and control is returned with val set 
to the current field length value. 


If the reserved bits:(rs) in the status word are used, the MEMORY request or a subsequent 
MEMORY request may be aborted. 


The format of the RAtl call for this function is: 


40 17 


. 59 
5 


° 


MESSAGE 


The MESSAGE function allows the user program to display a message on the system console 


‘display and enter it in a dayfile. 


If the job is of system origin, including a dollar sign as the first character of -the 
message and routing the message with option 2 causes the message to be flashed on the B 
display. 4 


The maximum length of a message is 80 characters; up to 40 characters per line are 
displayed. The message ends with either the first word containing 12 bits of zeros in any 
byte or at the 80th character. Before issuing the MESSAGE function, the user program must 
pack the display coded message in sequential locations, beginning at location addr. 


The format of the RAt+l call for this function is: 


59 40. 35 23 17 re) 


TRefer to the REDUCE (-) command in the CYBER Loader Version 1 Reference Manual. 
TtTo maintain compatibility with NOS/BE. , 
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Macro format: 


Location Operation Variable 
MESSAGE addr,x,R 
addr . Beginning address of the message. ‘The beginning address of the message 


cannot be within five words of the end of the job’s field length. 
x Message routing option. 


x=0 Message is placed in the system dayfile, the job 
‘dayfile, and job message buffer 1. 


+ Note: Nosrey¢ = -Message is eee in message eee : 
age x= Message is placed in job message buffer 2. 
& Sacimnurketiion 4 nessace x=37% -  . Message is placed in the job dayfile and displayed at 
f . line 1 of the control point. 
3 : x=4k Message is placed in the’ job dayfile. 
Le8 Sab hag (he onby x=5 Message is placed in the account dayfile. (SYo7 * $si=) 
x=6 Message is placed in the system dayfile, the job 
ral Eye (gre d syor oly) dayfile, and job message buffer 1. Same om F 
P ay =o x=7 Message is placed in the job dayfile and job message 


7 
= 


os 


buffer 1.4 Saeed. 


If x is not -specified, x=0 is assumed. If x is not defined or is an 

incorrect positive value, x=l is assumed. If x is a negative number, 
unpredictable results will occur. If x is the character string LOCAL, 
x=3 is used. - , : 


The job message buffers (1 and 2) allow you to display concurrently 
“messages that enter the dayfile and those that require operator action. 
Message buffer 1 is normally used to display information about the 
current status of the executing program; for example: 


> 


SKIPPING Lfn 
COPYING Lfn 


ASSEMBLING TEST 


Message buffer 2 is used by the system to issue error messages and 
warnings, and can be used by applications programs for the same 
purpose. Messages such-as the following should be placed in message 
buffer 2: . 

BUFFER OVERFLOW, FILE lL fn 

FILE Lfn NOT IN QUEUE 

TIME LIMIT, REPRIEVE INITIATED 


Message buffer 1 has a’ length of 50 characters (5 CM words); message 
buffer 2 has a length of 30 characters (3 CM words). 


TProvided for compatibility with NOS/BE. 
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R- 


These message buffers are displayed at the system console and can be 
displayed by user jobs using the ENQUIRE command. If there are messages 
in both buffers, the message in message buffer 2 is displayed; the 
message in message buffer 1 is displayed only if message ree 2 is 
empty (contains binary zero). 


The contents of the job message buffer(s) are displayed when you enter 
the immediate job status command cE from an interactive terminal (refer 
to section 8 of Volume 3, System Commands), and when you enter the 


ENQUIRE,UJN or ENQUIRE,JSN=jsn command to determine the status of one of 
your jobs. 

Only messages that are of interest to other than the job, such as the 
commands processed and compilers used, should be placed in the system 
dayfile (x=0). All messages of interest to the job, such as. the path 
taken by the programs and the number of records copied, should be placed 
only in the job dayfile (x=3). All messages placed in the job dayfile 
(x=0 and x=3) are counted by the system. If the number of messages 


issued by the job exceeds the limit for which you are validated, the job 
aborts. 


Auto recall bit. 


If the MSG RAt+1 request is issued directly (not using the macro) and the upper 12 bits of 
the location specified by the message address are zero, then bits 47 through 30 of this 
location are assumed to contain the beginning address of the message. This indirect 


addressing method is not supported by the macro call and unpredictable results will occur if . 
it is attempted. 


MOVE 


The MOVE macro moves a block of data from addr, to.addr2. This macro requires the 
common deck COMCMVE for absolute assemblies. 


Macro format: 


Location 


count 
addr, 


addrg 


Operation Variable 


MOVE count ,addr) , addr2 


Number of words in the block to be moved. 


Address of the first word of the block to be moved. 


Address of the first word of the destination. 


MOVE allows overlap in data moves; that is, addrg can be less than addr} plus count. 
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MOVE may access data from beyond the end of 
the source buffer. This could cause the 
program to abort if the last word address of 
the source buffer is within two words of the. 
end of the program’s field length. 
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in 


RECALL 


The RECALL macro enables the user program to relinquish the CPU until a function is 
completed or the CPU recall.time has elapsed (delay time is set by the installation, usually 
24 milliseconds). If the stat parameter is included in the call, control is not returned to 
the program until bit 0 of the word specified by stat is set. If stat is not included in 
the macro call, the program: relinquishes the CPU until the delay time expires, or until a PP 


_activity completes. 


Macro format: 


Location Operation Variable 
RECALL stat 
stat If this parameter is present, control is returned to the program when 


bit. 0 of the word specified by the address stat is set. This is usually 
the address of a FET. 


The format of the RA+l call for this function is: 


59 40 . 17 Ce) 
4 
mri[ ea) > *idS id 
| 4 


The auto recall bit, R, is set only if the stat parameter is specified. 


SUBR 
The SUBR macro enables the user program to distinguish between entering a subroutine and 
exiting from a subroutine even though control is transferred to the same address. Transfers 
to the subroutine are of the form: 

RJ tag 
Exits from the subroutine are of the form: 

EQ tagX 


Macro format:f 


Location Operation Variable 


tag SUBR 


Tt This macro is not available in SYSTEXT. The user program must specify systems text~ 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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SYSTEM 


With the SYSTEM function, the user program can request the system to process any 
three-character request. Refer to Request Processors, section 1, for a list of request 
processors. A PP program can be called from a CPU program if the first character of the 
name is alphabetic. Documentation of these programs (refer to the DOCMENT command in Volume 
3, System Commands) should be consulted for the functions available (for example, LFM, 

CPM). These should be used when macros do not exist to issue the functions desired. 


Macro format: 


Location Operation Variable 
SYSTEM req,R,P} ,p2 
req Three-character system request. 
R Sets the auto recall bit for the request. If specified, control is 


returned only after the request is completed. If = is specified, no 
executable code is generated, but cross-references are made. 


Pl Bits 17 through 0 of the request. 


P2 Bits 35 through 18 of the request. 


The format of the RA+] call is: 


Example 1: 
A CIO function request can be issued with the following SYSTEM request: 
SYSTEM CIO,R,addr,n 
where addr is the address of the FET for the file being read and n is the count for skip 
operations. If R is specified, the request is made with auto recall. When performing a 
CIO request in this manner, the user program must set the function code in FET+0. 
Example 2: 
The following shows the correct use of the = parameter: 


SYSTEM XYZ,= 


Routine XYZ will not actually be called, but the symbol XYZ will be created and KRONREF 
will recognize that this program calis XYZ. 
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WAIT 
The WAIT macro enables the user program to relinquish the CPU and remain in recall until a 


specified CPU delay time has elapsed. The delay time can range from the system default 
recall time (10 milliseconds is the. released default value) to 4095 milliseconds. 


Macro format: 


Location Operation Variable 
WAIT . delay 
delay The maximum length of time in milliseconds that the job will remain in 


recall (if a value greater than 4095 is specified, the system uses the 
value 4095).T 


The format of the RA+tl call for this function is: 


59 41 11 0 


: The ‘user program may be recalled before the delay time has elapsed if high: system “activity 
exists. ; a ; . 
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USER FIELD LENGTH DUMP REQUESTS 


The following requests enable you to transfer information residing in your job’s field 
length to a file. Common deck COMCSYS is required for absolute assembly of these requests. 
These requests can not be made from a program in which the SETSSM macro has been executed, 
or from a program that was loaded from an execute-only file. 


The SYSTEM macro is used to issue the user field length dump requests. Each type of request 
is identified by a three-character request code that appears as the first element in the 
variable field of the SYSTEM macro. 

DUMP EXTENDED MEMORY (DEP) 


‘This request dumps extended memory to file OUTPUT.f The format of the request is: 


SYSTEM DEP,R,addr 


R Auto recall bit. 
addr The address of a parameter word with the following format. 
, 59 47 23 0 
fwa The address of the first word to be dumped. If this 


parameter is not specified, the dump begins with the 
first word of your job’s extended memory. 


lwa The address of the last word to be dumped. This 
parameter must be specified. 


DUMP EXTENDED MEMORY WITH DISPLAY CODE (DED) 


This request dumps extended memory to file OUTPUT. The dump contains display code 
equivalents to the right of the octal word representations. The format of the request is: 


SYSTEM DED,R,addr 


R Auto recall bit. 
addr The address of a parameter word with the following format. 
_ 59 47 23 0 
fwa The address of the first word to be dumped. If this 


parameter is not specified, the dump begins with the 
first word of your job’s extended memory. 


‘lwa The address of the last word to be dumped. This 
parameter must be specified. 


TI£ the file OUTPUT is assigned to an interactive terminal, the dump is written to file 
ZZZDUMP instead of to OUTPUT. 
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BINARY DUMP OF CENTRAL MEMORY AND EXTENDED MEMORY (DMB) 


- This request creates .a machine-readable binary dump file of your job’s- exchange package, 
central memory, and extended memory on file ZZZZDMB. File ZZZZDMB is not rewound before or 
after the dump; if ZZZZDMB is assigned to your terminal before the dump, the system returns 
it and creates a mass storage file ZZZZDMB. ‘Each DMB request creates one logical record on 
ZZZZDMB. The format of the request is: 


SYSTEM DMB,R, em, rn. 


R Auto recall bit. 


em Determines whether. the system dumps extended memory. If a nonzero 
; integer. is specified, the system dumps extended memory. If em is zero 


or omitted, the system dumps only the exchange package and central 
memory ‘ 


rn Identifies the record name on file ZZZZDMB to which the dump will be 
written. rn is optional, but if it is specified it must be an octal 


value from 0 through 7777773. The system appends rn to the letter D 
to form a seven-character dump record name. If rn is greater than 


3777773, the job aborts after the dump completes. 


Each logical record of ZZZZDMB has the following format: 


59 53 47 


35 : 17 0 
a See ee er RT 
ava 
a) ee 


- Jast system program calledt | 


prefix 
table 


un Oo oT & Ww NY =| O&O 


TWord PGNR of the job communication area. 
ttWords CCDR of the job communication area. 
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59 aes a 17 0 
SS AT 
-59 ~— 583 17 . 0 


Pea ee 


«(a [ome SSC~C~S 
59 47 
a 
exchange 


: AO register 
30) AZ register 


package table 


central memory 
table 


5652 O 


extended memory 
table (appears only 
if extended memory 
is requested) 


-— 
= 


n Octal number of central memory words assigned to the job. 
n Octal number of extended memory words assigned to the job. 
A Space (display code value 55g). 


If an extended memory error occurs, the block in error will be filled with 400g words of. 
the following format. 


59 1 


° 


nnnn Word number of the block in error (starting with 1). 
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DUMP CENTRAL MEMORY (DMP) 


This request dumps central memory of your job’s exchange package to file OUTPUT. (If the 
file OUTPUT is assigned to the terminal, the dump is written to file ZZZDUMP instead of to 
OUTPUT.) The format of the request is as follows: 


SYSTEM DMP,R,lwa,fwa 
R Auto recall bit. 


lwa The address of the last word to be dumped.. This parameter must be 
specified if fwa is specified. 


fwa The address of the first word to be dumped. If this parameter is not 
specified but lwa is specified, the dump begins with the first word of 
your job’s central memory. 


If neither fwa nor lwa is specified, the dump includes the exchange package and 40g central 
memory locations before and after the program address in the exchange package. If either 
fwa or lwa is nonnumeric, the request is processed as if neither parameter had been 
specified. 


DUMP CENTRAL MEMORY WITH DISPLAY CODE (DMD) 


This request dumps your job’s central memory or exchange package to file OUTPUT. (If the 
file OUTPUT is assigned to the terminal, the dump is written to file ZZZDUMP instead of the 
OUTPUT.) The dump contains display code equivalents to the right of the octal word 
representations. The format of the request is as follows: 


SYSTEM DMD.,R,lwa,fwa 
R Auto recall bit. 


lwa The address of the last word to be dumped. This parameter must be 
specified if fwa is specified. 


fwa The address of the first word to be dumped. If: this:parameter is not 
specified but lwa is specified, the dump begins with the first word of 
your job’s central memory. 


If neither fwa nor lwa is specified, the dump includes the exchange package and 40g central 
memory locations before and after the program address in the. exchange package. If either 
fwa or lwa is nonnumeric, the request is processed as if neither parameter had been 
specified. 


QUEUE FILE MANAGER 


Queue file manager (QFM) performs functions associated with queue and dayfile protection. 
The majority of the QFM functions are for special system jobs. These functions are. not 
discussed in this manual (refer to the NOS Version 2 Systems Programmer’s Instant) since 
they are not available to the applications programmer. Functions available to the 
applications user allow a job to be rerun in the event of a system interrupt or DALGWALS 
failure. 
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The format of the call to QFM is: 


$9 40 35 23 17 i?) 
7A G 

2 ce 2 | 77, 7/7, 

R Auto recall bit. 

code Function code. 

addr Address of the request. 


RERUN (015) 


The RERUN macro sets the job rerun status, indicating that the job may be rerun in the event 
of system failure. All noninteractive jobs are initially given rerun status. The RERUN 
macro has no effect if used from an interactive job. 


Macro format: f 


Location Operation Var iable 
RERUN 


NORERUN (016) 


The NORERUN macro clears the job rerun status (initially enabled) and prevents a job from 
being rerun. With this macro the user program can specify when a job may be safely rerun. 
For example, if a job has just updated a critical data base, it is probably desirable not to 
rerun the job. The user program can use the NORERUN macro to prevent this. This macro 
affects noninteractive jobs only. The NORERUN macro has no effect if used from an 
interactive job. 


Macro format: t 


Location Operation Variable 


NORER UN 


LOADER REQUESTS 
The system provides routines to aid you in loading overlays or capsules at specific points 


during program execution. The overlays or capsules can reside on files attached to your job 
or in system libraries. : 


{This macro is not available in SYSTEXT. The user program must specify systems text PSSTEXT 
- or call common deck COMCMAC (refer to appendix F). 
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OVERLAY 


The OVERLAY macro processes a system request to the LDR processor. LDR provides the ability 
to load overlays to specified areas of the user program areae Depending on the parameters 
specified and the level of the overlay, control may or may not be returned to the calling 


program. 


The format of the RAtl call for this function is:T 


59 40 17 {e) 


esse ALC id 
ij 


R Auto recall bit. 


addr Address of the request. 


The load request. consists of. two to four words. The two-. to four-word block must be defined 


-by the user program for RAtl calls, but is defined by the system when called from the 
OVERLAY macro (only two words used). 


59. 8347 40__35 17 . 0) 


addr +0 


+ [er [oe He Mio Fl 
2 


+3 eptname 


name Source of name depending on the u and n options. 

levl First overlay level. 

lev2 Second overlay level. ; 
a Number of words in request-2 (bits 47-46). 

u Load option (bit 42). 

v Overlay flag (must be set to 1) (bit 41). 

e Call completion. flag (bit 36). 

lwa Last word address available for load. 

.fwa . The address at which the overlay is to be loaded. 

ovlname Name of overlay to be loaded (if n>l and u=l). 

eptname: eed point name when loading multiple entry point overlay (if n=2 and 

u=1). 


TLDV is processed by the system as the LDR call.. This is to provide compatibility with the > 


common product set. 
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The operation performed depends on the value of u, n, fwa, levl, and lev2. 


1. If u=0, n is ignored and name is the name of the file containing the overlay (lev1 
and lev2 are required). 


2. If u=l and n=0, name is the name of an entry point in an overlay from the system 
| libraryt (levl and lev2 are ignored unless the main program was loaded from a global 
library). 


3. If u=l and n#0, ovlname is the name of the overlay from the system libraryTt (levl 
and lev2 are ignored). 


4. If u=l and n=2, eptname is the name of an entry point in an overlay from the system 
libraryt (levl and lev2 are ignored). 


5. If fwa=0, the overlay is loaded at the address specified by the overlay. Otherwise 


the overlay is loaded at fwa. ® 
6. If levl=lev2=0, the (0, 0 overlay) control is transferred to the called overlay. 

Otherwise, control is returned to the caller with fwa replaced by the entry point 

address of the overlay. 


7. If e=l, control transfers to the specified entry point, eptname, in the overlay. 


Upon completion of the load, the following information is returned to the four-word block 
beginning at location addr: 


59 53 47 | 17 1°) 


addr +0 
+1 
+2 


[mene 
eptaddr Entry point address of the overlay. If n=2, eptaddr is.the address of 
eptname. 


Macro format: 


Location Operation Variable @ 
OVERLAY nan,lev,SYSTEM,fwa 
nan Address of file name in L format (display code, left-justified). 
lev Level of overlay. If not spectfied, level 0,0 is assumed and control is 


automatically transferred to transfer address encountered on overlay 
load (usually specified on IDENT pseudoinstruction of ABS programs). 
For overlay level (i,j), level is defined as: lev=i*100g+j. 


SYSTEM If SYSTEM is specified, file is loaded from system library and nam is 
name of overlay desired. 


fwa If this parameter is specified, fwa is the address where the overlay is 


to be loaded. The file is loaded at the address specified on the 
overlay if this parameter is not specified. 


Common decks required are COMCOVL and COMCSYS. : @ 


{The overlay is loaded from a user global library set file if the main program was loaded 
from a user global library set file. 


11-22 60459690 J 


After the macro is processed, Xl contains the address of the entry in the overlay. 


‘Example 1: 


OVERLAY TEST 


TEST CON 4LTEST 


This sequence of code loads overlay (0,0) from file name TEST and begins execution at 
the entry address specified by TEST. 


Example 2: 
OVERLAY A,01008,S,LDA 
SB2 x1 f 
JP Be 
A CON SLARITH 
LDA EQU * 


This sequence of code loads the ARITH routine from the system, level (1,0) library at 
address LDA and transfers control to the routine. 


If the request calls for the overlay to be loaded and executed and no fwa load address is 
specified in the request, the entry point address specified in the load table is used as the 
entry point address. If an fwa load address is specified in the request, bias the entry 
point address from the load table with the difference of the fwa load address specified by 
the request and the fwa load address specified by the load table; that is: 


Entry point address = (entry point address from load table) + (fwa load address 
, specified in the request) - (fwa load address from load table) 


If the request requires just an overlay load, the entry point address returned is the entry 
point address in the load table. 


Overlay loads from an execute-only file are 
always allowed in the case of a (0,0) 
overlay. For any other overlay, a load from 
an execute-only file is only allowed if the 
original. (0,0) overlay was loaded from the 
same file. 
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LOADD 


The LOADD macro allows the user program to locate procedures or fast dynamic load (FDL) 
capsules and have pertinent information returned to a specified address. Fast dynamic 
loading is a method of loading preprocessed binary routines. 


The format of the RA+tl call for this function is: 
4 
, ga 


R Auto recall bit. 
addr Address of parameter block. 
The parameter block consists of two words in the following format. 


8 


$9 47 29 17 
eC 


fo} 


addr+0O 


+1 


group name Name of the group of capsules or procedures for which a directory is 


requested. 
stat Status of call (ignored during request). Upon completion of call, stat 
is set to one of the following values. 
Value Description 
0 Function completion without error. 
1 Illegal function code. 
2 


Bad directory address or length (address plus length must be 
less than or equal to field length). 
3 Bad liblist address or length. 


The following errors may be combined with those preceding: 


10g An entry in the library list did not correspond to any known 
local or system library name, or an entry specified the name 
of file which was not a mass storage library. 

20g The specified directory space was not large enough to 
contain the entire directory. 


fc Function code. LDD sets bit 0 to one when the request is complete: 
0 Specifies capsule (record type CAP). 
404g Specifies procedure (record type PROC). 
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liblist Address of a list of libraries to be searched after the global library 
set. Zero if no set is specified. 


’ dirlen - Length, in central memory words, of the area to receive the generated 
directory. Upon completion of the call, it is set to the actual length 
that was needed for the complete directory (may be less than or equal to 
the value of the original call). © : 


directory Address of the area to receive the generated directory. 


When called, LDD searches first the global library set (refer to the CYBER Loader Version 1 
Reference Manual for a description of global library sets) and then the library set 
specified in the call. If a library file is found to contain one or more capsules belonging 
to the given group or the specified procedure, an entry is made in the directory. This 
entry is one of two different forms, depending on whether the library is a system library or 
a local file library. For a procedure, LDD searches the central library directory (CLD) if 
the specified procedure is not found elsewhere. 


For a local file library the format is: 


fo) 


9 17 


an 


For a system library the format is: 


p>) 
“ 
Nn 
ow 
~ 
~“ 
°o 


libord The library ordinal of the library containing the capsule. 


For each capsule or procedure found that belongs to the given group, LDD makes the following 
entry in the directory. , 


faddr Address, relative to the beginning of the directory, of the word 
containing the file entry associated with this capsule or procedure. 


r ; Residence of capsule or procedure: 
0 Mass storage. 
1 Mass storage and CM. 
2 - Mass storage and extended memory. 


TThe first character of the local file name must not be numeric. 
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caddr CM or extended memory address of capsule or procedure. 
daddr Disk address (relative PRU) of capsule or procedure. 
length ' Length of the capsule or procedure, including header, code image, and 


relocation and linking information, but excluding the prefix table. 


Macro format :f 


Location Operation Variable 
LOADD addr,R 
addr Address of parameter block. 
R Auto recall bit. 
LOADQ 


The LOADQ macro loads fast dynamic load (FDL) capsules from specified files. 


The format of the RA+l] call for this function is: 


$9 40 17 Ce) 
R Auto recall bit. 
addr Address of parameter block. 


The four-word parameter block must be defined as follows: 


auc 59 17 8 to] 
ep group name LLL 


+2 


+3 


{This macro is not available in SYSTEXT. The user program must specify systems text 


PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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file name 


stat 


fc 


group name 
capsule name 
fwa 


random 
address 


lwatl 


Name of file containing capsule. 


Status of LDQ call (ignored during request). Upon completion of 
call, stat is set to one of the following values. 


Value Description 


Function completion without error. 

Illegal function code. ; 

Bad address (must have fwa<lwat+tl<field length). 
Nonexistent file or file not on mass. storage. 
Bad disk address (out of file bounds). 

Capsule not found at specified location. 
Insufficient space provided for capsule. 


DAuOkwWNr oO 


If either error 5 or 6 occurs, the contents of the loadable area are 
undefined. ' 


Function code: 
0 Load capsule. 


LDQ sets bit zero to one when the request is complete. 


Name of capsule group. 


Name of desired capsule. 
First word address of the area into which the capsule is to be read. 


Location of capsule on specified file. 


' Last word address plus 1 of area for capsule. 


LDQ reads a capsule from the. specified mass storage location, removing the prefix table, but 
not altering the record otherwise. LDQ ensures that the location contains a capsule (60 
table). LDQ also determines that the entire capsule fits into the specified area and that 


the name is correct. 
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Macro format: T 


Location Operation Variable 
LOADQ addr,R 
addr Address of parameter block. 


R Auto recall. 


MEMORY ALLOCATION FOR OVERLAY LOADERS 


The overlay loaders load records into central memory. If a record begins with an overlay 
table (50g-, 5lg-, and 53g-identification word), it is loaded according to the 

relative address given in the table (figure 11-1). The beginning load address must be 
greater than 110g. For a 50g single entry point overlay, loading starts at origin minus 
one; for a 5lg multiple entry point overlay, loading starts at origin minus we minus one, 
where wc is the number of entry points. 


| _ 50,51, or 53 loader table | 5l, | _ 50,51, or 53 loader table | 53 loader Vz 
field length origin 


1 absolute data 


end - of - record 


Figure 11-1. Absolute Loader Memory Assignment 


Tt This macro is not available in SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
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INTERACTIVE TERMINAL REQUESTS 


The following requests perform functions associated with control of your interactive 
terminal. The calling format is show for each macro. 


The macros described in this section are 
intended for use by interactive origin jobs 
only. The use of these macros by other job 
origins will be ignored. 


DISTC MACRO tf 


The DISTC. macro enables an interactive program to prevent IAF from processing terminal 
control keys and commands. 


Capabilities similar to those provided by DISTC are available via reprieve processing (refer 
to Reprieve Processing, section 10). Because reprieve processing provides extended 
features, it should be used instead of DISTC. 


Macro format :tT 


Location Operation Variable 
DISTC st ,addr, INT 
st Control . status: 
ON Activates program terminal control. 
OFF Deactivates program terminal control. 
addr Specifies an interrupt address which the system uses to inform the 


program that a terminal operator attempted to interrupt or terminate the 
program. This parameter is valid only if st=ON. If addr is not 
specified, the program is not notified of attempted terminal control. 


INT If INT is specified when terminal control is attempted, the system 
copies the program operating registers (exchange package)tff to the 
20g-word area starting at addr. The program address is changed to 
addr+20g (that is, execution continues at addr+20g). If INT is not 
specified, the contents of addr are determined by the type of user break 
attempted: if user break 1, the contents of addr are set to l. If user 
break 2, the contents of addr are set to 2. The program can check the 
location periodically to determine if the terminal operator has 
attempted to interrupt or terminate the program. 


{ This macro will’ be deleted in a future version of NOS. Extended reprieve processing 
(refer to the REPRIEVE macro in section 10) should be used instead of DISTC. 
{This macro is not available in SYSTEXT. ‘The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). 
TTTA system request, XJR, allows the user program to restore the operating registers and . 
resume normal processing after the interrupt processing has been completed. 
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The interrupt address remains the same after the program is notified of an attempted 
interrupt. Once a terminal control is set or cleared, that status remains in effect until: 


© The program issues a DISTC macro that changes the status. 


e The program terminates, which returns the terminal to command mode. 


° You log off or disconnect the terminal. If the terminal was disconnected, you may 


recovere 


If the executing program is continued after recovery, the terminal control 


status remains as it was prior to the disconnect. If the executing program is not 
continued, the interrupt address is cleared. 


The following is a list of terminal control sequences and their effect when you select the 
disable terminal control feature (the denotes the message terminator key). 


Phase 


Waiting 
for input 


Generating 
output 


Executing 


for different terminals. 
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Sequence f 


CTRL/T 
or 
CTRL/P 


BREAK 
CTRL/T 
or. 
BREAK 
CTRL/P 


CTRL/T 


or 


CTRL/P 


Effect 


You may enter this sequence at the beginning of any input 
line unless transparent input mode has been selected. 

If an interrupt address was specified, the program is 
notified of attempted control. 


If an interrupt address was specified, the program is 
notified of attempted control. When the BREAK key is 
pressed, output is suspended. However, unless CTRL/T €) or 
CTRL/P €) is entered next, the program is not notified of 
an attempted terminal control. 


If any other sequence is entered, or if just a is 
entered, the program is not notified of terminal control 


and the output operation continues. 


If an interrupt address was specified, the program is 
notified of attempted control. 


An error will occur if a DISTC macro is 
issued while REPRIEVE processing is in 
effect (REPRIEVE processing is described in 
section 10 of this manual). The DISTC macro 
will be ignored if it is issued while EREXIT 
processing is in effect (EREXIT processing 
is described in section 6 of this manual). 


{The termination (sometimes referred to as user break 2) sequence (that is, CTRL/T¢®) and 
interruption (sometimes referred to as user break 1) sequence (that is, CTRL/P€A)) may vary 
Refer to Volume 3, System Commands, for further information. 
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CSET MACRO 


The CSET macro sets the initial and current character set mode of the terminal to either 
ASCII or NORMAL. ; 


Macro format:T 


Location Operation Variable 
CSET mode ,C 
mode ASCII Set ASCII 128-character set mode. 
NORMAL Set ASCII graphic 63/64-character set mode. 
RESTORE Set current terminal character mode to initial terminal 


character mode. 


Cc Change initial and current terminal character mode to that specified; if 
Cis omitted, only the current mode is changed. 


The use of this macro may cause the character 
mode of the terminal to switch prior to the 
printing of all previous output. This can be 
prevented by preceding the macro call with an 
input request with recall or with a rollout 
request, or by flushing the output buffer 
with a WRITER or WRITEF request. 


PROMPT MACRO 


The PROMPT macro enables or disables the issuing of the terminal input prompt (a question 
mark). The input prompt is turned on at the beginning of each job step. 


Macro format :f- 


Location Operation Variable 
PROMPT mode 
mode Input prompt mode desired: 
ON Terminal input is requested with a question mark. 
OFF No terminal input prompt is issued. ; 


TThis macro is not available in-SYSTEXT. The user program must specify systems text 
PSSTEXT or call common deck COMCMAC (refer to appendix F). : 
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SETSLM MACRO 


The SETSLM macro returns or sets the display mode of the interactive terminal associated 


with a job. 


Macro format:f 


Location Operation Variable 
SETSLM addr ,W 
addr Address of parameter word. 
W If present, the terminal's display mode is set according to the values 


specified in the parameter word. If omitted, the terminal's current 


display mode is returned to the parameter word. 


Using the SETSLM macro to set the display 
mode of the interactive terminal may produce 
unpredictable results when NOS full screen 
products are used. Use the SCREEN or LINE 
command to set the display mode. 


Parameter word format: 


59 6 5 0 
eo 
status Terminal display mode status. 
Bit(s) Description 
0-5 Terminal model ordinal. 
Ordinal Mnemonicft Terminal Type 
0 None Any terminal that does not support 
screen mode. 
1 ‘User User-defined terminal. 
2 721 CDC 721. 


TThis macro is not available in SYSTEXT. The user program must specify systems text 


PSSTEXT or call common deck COMCMAC. 


TfThese mnemonics and their corresponding ordinals are defined in common deck COMCGTO. 
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Bit (s) Description 
6 Terminal display mode. 
Value © Description 
1 Screen mode. 
0 Line mode. 


TSTATUS MACRO 


The TSTATUS macro returns the status of the terminal. Information returned includes 
terminal type, the interactive subsystem being used, the terminal number, character set 
information, parity, whether the format effector mode is set to USER or SYSTEM, duplex and 
tape mode status, and the current interrupt address. If the connection status is not on- 


line, the only valid field is cs. All other fields are zero except the tid field which is 
& set to blanks. 


Macro format: + 


Location Operation Variable 
TSTATUS addr 
addr _ Address of two-word status block. . | 
len If present, sets the length of the status block. If len is greater than 
& : 2, all three words of the status block are returned. If len is less 


than 3 or omitted, only the first two words of the status block are 
returned. 


Status block format: 


tid Left-justified, blank-filled display code terminal type identification: 
Type Description 
NAMIAF : Network terminal. 
TPM Two-port. multiplexor terminal. 
TTY Stimulation or multiplexor terminal. 
blank Terminal is not on-line. 
@ {This macro is not available in SYSTEXT. The user program must apecity systems text 
PSSTEXT or call common. deck COMCMAC (refer to appendix F). 
eo | 
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sys 


tn 


nwk 


cs 


te 


Subsystem ordinal: 


Ordinal 


Au Pr WDH PO 


Description 


Null subsystem. 
BASIC subsystem. 
FORTRAN subsystem. 
FTNTS subsystem. 
Execute subsystem. 
Batch subsystem. 
Access subsystem. 


Terminal number (octal) . 


Type of network: 


Value 


0 
1 
2 


Description 


Job not connected to NAM. 
Job connected to NAM/CCP. 
Job connected to NAM/CDCNET. 


Connection status: 


Value 


(octal) 


0 

1 

2 
3-13 
14-17 


Terminal class: 


Class 


(octal) 


Description 


Not interactive. 

Detached. 

On-line. 

Reserved for CDC. 
Reserved for installation. 


Description 


M33, M35, M37, or M38 TTY 

Control Data 713-10, 722, 751-1, 752, 756 
Control Data 721, 722-30 

IBM t 2741 

M40 TTY 

Hazeltine 2000 

DEC tT VT100, Televideo 924, 950, 955 
Tektronix 4010, 4014 

HASP Protocol (postprint format control) 
200 User Terminal 

Control Data 714-30 

Control Data 711-10 

Control Data 714-10/20 

HASP Protocol (preprint format control) 
Control Data 731-12, 732-12, 734 

IBM 2780 

IBM 3780 

IBM 3270 


f DEC is a registered trademark of the Digital Equipment Corporation. IBM is a registered 
trademark of International Business Machines. 
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Current interrupt address if specified on DISTC macro; if INT is also 


specified on the DISTC macro, bit 35 is set. 


Transmission code: 


Code : Description 
3 Interactive terminal (only code returned). 
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st Terminal status bits: 
Bit Description 
0 Parity (Odd if set). 
1; Initial character set (ASCII if set). 
2 Current character set (ASCII if set). 
3 Full duplex. 
4 Tape mode. 
5 Brief mode. 
6 User format effector mode. 
7-11 Reserved. 


EFFECT MACRO 


The EFFECT macro allows the user program to control the formatting of terminal output. 
Terminal output is normally controlled by IAF. When the mode is set to USER, the user 
program must supply all formatting for terminal output. 


Control bytes 0001, 0002, 0003, 0005, 0010, 0013, 0014, 0015, and 0016 should not be used [ 


while the mode is set to USER. Use of these bytes may result in loss of control over the 
carriage. This macro affects only terminals connected to the system by way of NAM. 


Macro format: 


Location Operation Variable 
EFFECT mode 
mode SYSTEM IAF controls all formatting of terminal output. 
USER User program controls all formatting of terminal output. 
omitted IAF controls all formatting of terminal output. 


Only preprocess format effectors are 
supported in USER effect mode. The slant 
and period are not supported in this mode. 
For a list of format effectors and a 
discussion of the effects on a specific 
terminal class, refer to the NAM Version 
1/CCP Version 3 Terminal Interfaces 
Reference Manual. 


The ? prompt, normally supplied by the 


system to request input, is not displayed 
when format effectors are user-supplied. 


60459690 J ; 11-35 


PROGRAM WRITING TECHNIQUES . 12 
ca a a a a a Oe 


WRITING PROGRAMS UNDER NOS 


Listings of programs that use the macros and common decks described in this manual can serve 
as an aid to understanding many of the features described in this manual. For example, to 
obtain a listing of the COPYC program, enter the following commands after accessing the 
system OPL.7 


MODIFY, LO=E,Z./*EDIT, COPYC 
COMPASS , I, L=list, S=NOSTEXT,B=0. 
ROUTE, list, DC=LP. 


If you follow the documentation standards described in appendix I, you can use the 
documentation utilities to document your program. These specifications are supplied as a 
guide to enable you to understand the format of system programs and to give you an idea of 
how to structure programs. 


You should organize the program area, buffers, and working storage areas in a manner that 
uses the least amount of memory for the shortest period of time. This provides better 
performance and more efficient use of system resources. Areas of code that are used once, 
such as preset routines, should be overlayed with buffers that are used later in the 
program. All main programs should be set to load past location 110g since areas before this 
address contain program and system parameters.jt If a program has several entry points, the 
origin should be higher. Placing FETs, table pointers, and other critical data areas at the 
beginning of the program aids in debugging because these areas do not change addresses as 
code in the program is changed. 


PARAMETER PROCESSING 


When a program is initiated, the command parameters are stored in the job communication area 
(refer to figure E-1) beginning at ARGR (RA+2) through RA+tn (n cannot exceed 63g). These 
parameters are terminated by a zero word. The display code representation of each parameter 
(with binary zero f£i11) is stored in the top 42 bits of the corresponding ARGR word; a 
representation of the separator or terminator following the parameter is stored in the 

bottom 18 bits of that word. The number of parameters stored in the job communication area 

is placed in the lower 18 bits of ACTR (RA+64g). The name of the command is placed in bits 

59 through 18 of PGNR (RA+64g). The’parameters are stored in either operating system or 
product set format. The command image is stored beginning at CCDR (RA+70g) . l 


If the parameters are stored in operating system format, the comma, period, and right 
parenthesis are stored as zero. For all parameters and valid separators except the comma, 
their display code equivalent is stored. 


f Your site must control access to the system OPL as required by the site’s licensing 
agreement. Contact your site analyst to obtain the procedure for gaining access to the 
system OPL. : s 

tt Refer to appendix E. 


@ 
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If the parameters are stored in product set format, separators and terminators are stored as 


follows: 


Character Code (Octal) 


’ 1 
= 2 
/ 3 
( 4 
+ 5 
- 6 
; 10 
)oor. 17 
Others 16 


Parameters for user programs are normally stored in product set format. You can force 
operating system format in either of two ways: 


@ Prefix the command with a slash (/). 


@ For programs loaded from a global library set, include an NPC= entry point in the 
program. 


Example : 


When a program is loaded from a local file. with the following command: 


TEST, A=B,C=D,E,F. 


the command parameters are stored in product set format and the contents of central 
memory are as follows: 


ARGR RA+2 0100 0000 0000 0000 0002 A B 
+3 0200 0000 0000 0000 0001 B A 
+4 0300 0000 0000 0000 0002 Cc B 
+5 0400 0000 0000 0000 0001 D A 
+6 0500 0000 0000 0000 0001 E A 
+7 0600 0000 0000 0000 0017 F 0 
+10 0000 0000 0000 0000 0000 

CCDR RA+70 2405 2324 5601 5402 5603 TEST,A=B,C 

RA+71 5404 5605 5606 5700 0000 =D,E,F. 
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If the command is changed to: 
/TEST,A=B,C=D,E,F. 


the command parameters are stored in operating system format and the contents of 
locations RA+2 through RA+t10g appear as follows: 


ARGR RA+2 0100 0000 0000 0000 0054 A = 
+3 0200 0000 0000 0000 0000 8B 
+4 0300 0000 0000, 0000 0054 Cc = 
+5 0400 0000 0000 0000 . 0000 
+6 0500 0000 0000 0000 0000 &£ 
+7 0600 0000 0000 0000 0000 F 
+10 0000 0000 0000 0000 0000 

CCDR = ——séRAH7O. 5024 0523 2456 0154 0256 /TEST,A=B, 

“Rae 0354 0456 0556 0657 0000 C=D,E,F. 


NOTE 


If you are using the common deck COMCARG 
(refer to appendix F) for argument 
processing, you do not need to be 
concerned with the different formats, 
since COMCARG processes both formats 
correctly. 


If the program with an ARG= entry point in its entry point list is loaded from a global 
library set, no command parameters are checked and no parameter list is stored. 


SPECIAL ENTRY POINTS -’ 


Absolute programs loaded from global library sets may contain entry points to perform 
special functions. Special entry points are specified by the COMPASS pseudo instruction 
ENTRY. As shown below, they typically follow the normal entry points. 

IDENT EXAMPLE, FWS 

ABS : 

ENTRY A 

ENTRY B 

ENTRY NPC= 

SYSCOM B1 
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The following entry points are special entry points: 
ARG= Programs which do their own processing of command parameters may use this entry 
point. The parameters are not stored in ARGR (RA+2) as would normally occur, but 
rather the command image is passed in CCDR (RA+70g). In addition to the parameters, 
the command image includes the program name and any prefix options (such as $ or /). 
This allows commands to contain parameters that do not conform to the normal 
constraints of NOS command syntax. The program name must be recognizable, that is, 
it must follow the same rules as a NOS file name and end with the separator 
et / = ( 

or any other character with a display code value greater than 44, except 
*) § 

and blank. 


MFL= Use this entry point in a program to specify the minimum field length required for 
execution. This entry point differs from RFL= in that the RFL= always changes the 
running field length to the specified value. 


When a program with an MFL= entry point is executed, it determines the running field 
length as follows: 


If MFL= is greater than 200000g, the running field length is set to the greater of: 


@ The field length specified on the JOB command (byte 1, word FLCW of the 
control point area) 


e The value of MFL= minus 200000 
If MFL= is less than 200000g, the running field length is set to the greater of: 
e The current running field length 


@ The value of MFL= 


NPC= This special entry point causes the parameter list to be stored in NOS format, not 
product set format. (Refer to Parameter Processing earlier in this section.) 
RFL= The system uses the value of this entry point as the running field length (amount of 


central memory) for the job. 


SDM= Use this entry point in a program if you wish to suppress the dayfile message issued 
by the system and issue your own dayfile messages. The system will then not issue a 
dayfile message of the command image when the program is executed. It is your 
responsibility to issue any desired dayfile messages. 


An example of SDM= usage would be a command with privileged information. The 
program could issue a dayfile message with this information removed, and thus the 
dayfile would yet contain evidence of the command being executed but not the 
privileged information. 
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WRITING INTERACTIVE PROGRAMS 


You may choose to write interactive programs in languages other than those oriented 
specifically to the terminal (for example, COMPASS). You can also convert some batch 
application programs to interactive programs. The following description of system 


conventions acquaints the user with potential problem areas in performing this conversion or 
in writing interactive programs. 


CONVERSION PROBLEMS 


The major difference between an interactive job and a batch job is in the handling of files 
assigned to a terminal. Since the system is designed with a common control interface to all 

_ types of equipment, the applications programmer need not be concerned about the specific 
piece of equipment with which. the program is communicating. 


Certain. problems arise when application programs not written with terminal-interaction in 
mind are converted to interactive programs. These problems are: 


e Each line of terminal input is considered a logical record. This causes two basic 
problems. i é 


- First, any program that terminates input processing on an EOR processes only 
one dine of input. 


Second, programs that read ahead on input place a special significance on an 
EOR, and therefore cannot effectively interact while accepting these 
one-line records. This problem is minimized by the design of NOS 


input/output. However, when the problem does occur, it is fatal to program 
execution. 


e Many programs output more than 72 characters per line. This may result in 


unacceptable output; however, this is easily corrected by. using the LO72 command or 
by reformatting the output in the program. 


Many programs perform unnecessary write requests on output. This can cause high 
system overhead. 


Portions of the NOS standard product set are modified to correct these problems. 


DEFAULT FILE ASSIGNMENTS AND SPECIAL FILE TREATMENT 


All jobs interacting with your terminal have the INPUT and OUTPUT files assigned to the 
‘terminal unless you or a program assigns them to a different device. You can assign a file 
to the terminal by assigning a file to equipment TT using the ASSIGN command; you can assign 
the INPUT or OUTPUT file to mass storage by specifying a device type of MS on the ASSIGN 
command. A user program can make similar assignments with the REQUEST macro. 


‘Normally, an interactive program need not check for EOI on INPUT; however, you must ensure 


that INPUT is checked for EOI file status if INPUT might be assigned to mass storage. 
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SPECIAL HANDLING 


When a program makes. a read request with recall on a terminal input file, the. circular 


buffer. of a terminal file can be automatically flushed (as if an EOR write had been 
performed) before the system issues the read request. 


A program can use one of the following methods to ensure that output.data is sent to the 
terminal. in this way. 


_The program can specify a list of files (refer to the SETLOF Macro, section. 6) from — 


which the system determines the appropriate file name. This iS -the preferred method. 


The program can store FET pointers, which specify the files to be flushed, in RA+2 
through RA+63g. The FET pointer is the file name left-justified with zero- “fill in 
bits 59 through 18 and the address of the FET in bits 17 through 0. 


In using the first wethod: the system checks only the first file in the list. This file 
must meet the following criteria. . 


The file must either be aseigned:4 to che terminal hdevice type equals TT in une FET) 
or, if unassigned, must be named OUTPUT. 

The file must meet the conditions described under the flush bit (refer to 
description of the flush bit, FET description, in section 2). 


In using the second method, the system uses the first file that meets the preceding criteria. 


’ 


OTHER SPECIAL HANDLING 


The following additional considerations apply to the execution of interactive programs. 


An EOR or EOF write on a terminal file has no special significance except that it 
ensures that the buffer is dumped to the terminal. 9 


When terminal input data is passed to an executing program, the following convention 
is followed. 


If the input data consists of data followed by a carriage return, the system 
supplies an EOR level of .one (level number is in bits 17 through 14 of FET+0). 

If there is no data input but only a carriage return, the system supplies an EOF. 
The EOF will have an EOR level of 0; the FET status field will be 000031. 


A program can process input from a terminal properly by sensing an EOR level of 

1. The system input/output macros and common decks (except the READO macro) are 
coded to handle this case properly. Most of the system utilities interact with 

a terminal in this manner. : j 


Input from a terminal is handled in the same manner as the CIO READSKP request. 
If the program’s buffer is not large enough to accommodate a full line of input, 
the data is truncated and the excess is lost. No error code is returned. 
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A program that is interacting with a terminal should not do a recall ona file 
assigned to a terminal if it does an EOR or EOF write on the file to clear the 
buffer (do not specify the r option on WRITER or WRITEF macros). If recall is 
specified, an extra rollout of the program may be required before the program 
terminates. If the conventions mentioned earlier concerning the status of output 
are followed, it is not mandatory to write an EOR or EOF to clear the buffer; 
however, if it is done without auto recall (to remain compatible for batch use, for 


example) as the last operation before the ENDRUN macro, little additional system 
overhead is incurred. 


If the conventions for special handling are followed, a job being rolled out by the 
system has all completed lines of data in the output buffer sent to the terminal. 


If a program aborts because an error occurs, the contents of the first message 
buffer of the control point area are sent to the terminal as part of the output. 
Messages can be placed in this area using the MESSAGE macro. Messages longer than 
48 characters are truncated to 48 characters. If you are in the batch subsystem, 
this message buffer is always sent to your terminal at the end of each job step, 
except for job Btehe that are within a procedure file. 


If a buffer argument error is detected on an output buffer when output is being 
issued automatically, the output is ignored and the FET is not acted on. This error 


usually indicates that the executing program has seetrove? part of its own field 
length. 


A COMPASS program can determine whether it is interacting with a terminal input or 
output file by checking the type of equipment to which the file was assigned (byte 
zero of FET+1). Refer to the common deck COMCSTF, appendix F. 


PROGRAM CONTROL OF TERMINAL ACTIVITY 


The remainder of this section describes methods of controlling terminal activity wuen 
| connected to the Interactive Facility (IAF). 


| You can control terminal activity in the following ways. 
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Include control bytes in your program output to control the positioning of the 
printing element and define alternate input modes. 


Enter various characters or sequences of characters to control program execution. 


Issue a REPRIEVE macro (refer to section 10) to disable the terminal operator’s 
control of the user program during various phases of execution. 


Issue a CSET macro to change the character set of the terminal. 
Issue a PROMPT macro to control the issuing of the input prompt. 
Issue a TSTATUS macro to determine certain terminal characteristics. 


Issue an EFFECT macro to control the formatting of your terminal output. 
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CONTROL BYTES 


A control byte is a 12-bit quantity, right-justified in bit position 0, 12, 24, 36, or 48 of 
a CM word. 


You must ensure that data is not mistaken 
for a control byte. For example, in the 
64~character set, the characters :D at the 
beginning of a line and followed by an 
end-of-line will cause you to be logged off 
if they are written to the terminal output 
file, since the code 0004 is transmitted. 


The following paragraphs describe the bytes available to a user program and their functions. 


Symbols for most of these control bytes are defined in the system OPL common deck COMSTCM, 
and may be used by COMPASS programs. 


0000—End-of-Line 


‘End-of-line generates a carriage return and line feed, positioning the terminal. printing 
element at the beginning of the next line. An end-of-line consists of 12 to 66 bits of 
zero, right-justified in one or two central memory words. 


0001, 0002—End-of-Block 


This byte prevents the positioning of the terminal printing element at the beginning of the 
next line. An end-of-block byte can be used to allow the terminal user to enter input on 
the same line as the input request is printed. This byte must be followed by an 


end-of-line. If not followed immediately by a read request, any output following this uate 
may be lost. . 


0003—Auto input 


This byte.is used by IAF for auto mode input. The preceding characters in the line in which 
this byte occurs are sent to the terminal and are also retained as the first characters of 


the input line. The network can retain a maximum of 10 characters. Also, note the 
following: 


e The user may type ahead without losing data. 
e This byte must be followed by an end-of-line. 


e The next terminal operation must be an input request. The terminal prompt (a 
question mark) is suppressed. In general, if you want to suppress prompts, the 
PROMPT macro should: be used. — 
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Refer to Volume 3, System Commands, for further information about auto mode input. 


The 0003 control byte cannot be used in 
conjunction with transparent output. 


0004—Log Off User 


This byte disconnects the terminal from IAF and the network. This byte must be the first 
byte of a line and must be followed by an end-of-line. ; 


0005—initiate ASCIi Input | 


This byte causes the next line of input to be translated into 6/12 display code. The 
terminal prompt (a question mark) is suppressed. This byte must be followed by an 
end-of-line. On the subsequent input, all terminal control characters or sequences (refer 
to Control of Program Execution in this section) and terminal definition commands are 
processed as they are for normal input mode unless the SE terminal definition command has 


been entered (refer to Volume 3, System Commands). End-of-line (normally a carriage return) 
terminates 0005 input mode. 


If input has been typed ahead when this byte is issued, that input is translated in the old 
mode. 


0006— Initiate Transparent Input Mode 


This byte changes the input mode from normal or ASCII to transparent mode. The terminal 
prompt (a question mark) is suppressed. The byte must be byte 0 of the first word of a line 
and the word must be terminated by an end~-of-line. Bytes 1 and 2 are defined as follows: 


Byte 1 Specifies the maximum number of characters (up to 77778) to be received before 
input is terminated. If byte 1 is 0, the number is assumed to be l. 


Byte 2 Specifies the termination code. When a character is received from the terminal 
that matches this byte, the input: operation is terminated. Depending on the 
parity specified for the terminal connection, the lower 8 bits of byte 2 are . 
matched against all 8 bits of the input character, or the lower 7 bits of byte 2 
are matched against the lower 7 bits of the input character. If bit 11 of this 
byte is set, no termination character is assumed Jf. ; 


This conversion mode packs each 8 bits of data as the lower 8 bits of.a 12-bit byte and sets 
the upper bit (bit 11). The exhaustion of the character count or the occurrence of the 
termination code causes the end-of-line condition to be set. A 0007 byte is forced as the 
first byte of input so'the data is transmitted as transparent output if it is listed. 


TFor more information on parity options, refer to the NAM Version 1/CCP Version 3 Terminal 
Interface Reference Manual. : 
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'A user selected input prompt should follow the 0006 word if it is necessary to guarantee 


that the terminal is in transparent input mode before input is entered. For example, the 
following two words, when written to an ASCII-code terminal output file, switch the terminal 
to transparent input mode and issue three BEL characters (ASCII code 007) at which point 
transparent input mode is in effect. 


If input has been typed ahead when this byte is issued, that input is translated in the old 
mode. 


0006 0012 0015 0000. 0000 
0007 4007 4007 4007 0000 


Byte 1 of the 0006 word specifies a maximum. character count of 10 (12g) and byte 2 
specifies a termination character of carriage return (015g ASCII code). Refer to the 
description of the 0007 control byte for the second word. 


The use of transparent input with CYBER 
Record Manager and/or product set utilities 
(including compilers) may yield 
unpredictable results. It is advisable to 
determine how a particular product set 
member treats transparent input before 
proceeding. 


0007— Initiate Transparent Output 


This byte initiates transparent output. If you wish to output. data formatted as described 
for transparent input, a 0007 byte must precede the data. This mode continues until a 
nontransparent output data byte is detected. While transparent output is in effect, an 
end-of-line will not cause termination of the transparent output to occur. This is also 
true for a carriage return and a line feed. The 0007 byte must be byte 0 (bits 59 through 
48) of the first word of a line. 


A transparent output data byte is in the format 4xxxg, where xxx is the 8-bit octal code 
for the character being printed. Bits 11 through 8 of a transparent output data byte are 
always set to 10009. If this pattern is not detected, the terminal is switched to the 
original (normal or ASCII) output mode; this feature can be used to output normal or ASCII 
data immediately following transparent data without explicitly specifying a termination 
(end-of-line). The characters 5, 6, 7, and 8 (display codes 40g, 41g, 42g, and 43g) | 
match the transparent mode bit pattern when in the upper half of a byte and are interpreted 
as transparent data. Therefore, these characters cannot be used to terminate transparent 
output. Once transparent output mode is terminated, it remains cleared unless resumed by a 
0007 control byte. : 


The following word, when output from an ASCII-code terminal, produces a line feed and prints 
a question mark. There is no carriage return or line feed after the question mark. 


0007 4012 4077 0000 0000 
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The 4012 byte produces a line feed (012 is the ASCII code for line feed) and 4077 is the 
question mark. Similar output can be obtained with the following: 


0007 4012 7100 0000 0000 


Here 71 is the display code for a question mark and 7100 is a nontransparent data byte. 
Transparent output is terminated at the question mark and the end-of-line produces a 
carriage return and line feed. ; 


A control byte that changes the terminal input mode (0003, 0005, or 0006) prevents the 
system from printing a question mark in response to a program request for input. However, 
in all other cases, a read request on the input buffer causes the system to print a question 
mark at the terminal (unless the program has issued a PROMPT OFF macro). 


The use of transparent output with CYBER 
Record Manager and/or product set utilities 
(including compilers) may yield 
unpredictable results. It is advisable to 
determine how a particular product set 
member treats transparent output before 
proceeding. 


0010—Terminal Redefinition for NAM/CDCNET 


This byte enables you to alter the characteristics of a terminal that is connected through 
IAF. The 0010 byte string must have the following format: 


byte 2 [1 [attribute number 
byte 3 bytes for attribute value (n) 
byte 4 


e ° ; 
e ; 
e e- 
“ byten+3 [| attributevatue 
byten+4 attribute number 


byte n+5 bytes for attribute value (m) : 
byten+6 


byten+m+5 
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Note that the byte string begins with 0010 and ends with a zero byte (end-of-line). 
Additionally, the upper bit of all intervening bytes must be set to 1 to prevent a zero’ 
value from being interpreted as an end-of-line. The. n and m shown above Fepresent the 
number of bytes required to specify the attribute values. 


Table 12-1-lists the terminal attributes along with their attribute numbers, the number of | 


-bytes required to specify the attribute values, and the allowable attribute values. For 


more information on the attributes~-for instance, the defaults~-refer to the CDCNET Terminal 
Interface Usage Manual. 


As an example, consider the following three attributes and the desired redefinitions: 


Attribute _ Bytes - Desired 
Attribute 3 Number Required . - Value 
Page width 110g 1 100 (144g) _ 
Network control character , 100g 1 % (458) 
Transparent euwase Lenaen ' 10g ge - 600 (11308) 


The following 0010 control byte string would produce the desired changes: 


0010 4310 4001.4144 4300-4001 4045 4210 4002 4130 0000 


0011—Initiate ASCII Output 
This byte is used to initiate 128-character ASCII output (6/12 display code). This: byte 


must be byte 0 (bits 59 through 48) of the first. word in the output line and applies only to 
the line currently being output. . 


0012—Reserved 


This byte should not be used. 


0013—End-of-String 


This byte allows a user to terminate a line of output data without repositioning the 
terminal carriage. This byte must be followed by an end-of-line (which is ignored) and 


‘output continues with. subsequent data. The 0013 byte should not be used where the effect of 


an end-of-line is needed (for example, the end. of. a logical line on a‘synchronous terminal). 


0014—Internal End-of-Block 


This byte is. the first byte of a word and is ‘followed by an end-of-line. This byte is 
reserved by NOS and should. not be used since it may cause loss of data. 
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Table 12-1. NAM/CDCNET Terminal Redefinition Attributes (Sheet 1 of 2) 


Attribute 
Number 
(Octal) 


Allowable 
Values 


Bytes for 
Value 


Attribute (Mnemonic) 


Attention character (AC) 


Character 


Attention character action (ACA) 0-9 


Backspace character (BC) 


Character 


Backspace window (BW) 


PW, 10-255 


Begin line character (BLC) 


Character 


Break key action (BKA) 


0-9 


Cancel line character (CLC) 


Character 


Carriage return delay (CRD) 


0-1000 (milliseconds) 


Carriage return sequence (CRS) 


Any 0-2 characters 


Character flow control (CFC) 


Yes (1), no (0) 


Code set (CS) ASCII (0), 


BPAPL (1), 
TPAPL .(2) 


Echoplex (E) Yes (1), no (0) 


End line character (ELC) Character 


End line positioning (ELP) NONE (0), CR (1), 


LFS (2), CRLFS (3), 


End output sequence (EOS) Any 0-4 characters 


End 


page action (EPA) NONE (0), FFS (1) 


End 


partial character (EPC) Character 


End partial position (EPP) 


NONE (0), CR (1), 
LFS (2), CRLFS (3) 


Fold line (FL) 


Yes (1), no (0) 


Form feed delay (FFD) 0-3000 (milliseconds) 


Form feed sequence (FFS) Any 0-7 characters 


Hold page (HP) Yes (1), no (0) - 


Hold page over (HPO) Yes (1), no (0) 


Input block size (IBS) 


80-2000 
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Table 12-1. NAM/CDCNET Terminal Redefinition Attributes (Sheet 2 of 2) - 


Attribute : 
Number Bytes. for Allowable 
Attribute (Mnemonic) (Octal) Value Values 


Input editing mode (EM) NORMAL (0), 
TRANSPARENT (1) 


Input output mode (10M) UNSOLICITED (0), 
‘ SOLICITED (1), 
FULL DUPLEX (2) 


Line feed delay (LFD) 2° . 0=1000 (milliseconds) 


@ Line feed sequence (LFS) : Any 0-2 characters 
Network command character (NCC) —— . Character 
Page length (PL) 0, 2-255 
Page width (PW) ‘ 0, 10-255 
Parity type (P) - | ZERO (0), MARK (), 
, EVEN (2), ODD (3), 
NONE (4) 
®@ _| Partial-character forwarding (PCF) Yes -(1), no (0) 
| Response action (RA) ‘ a lie } SEND (0), DISCARD (1) 
Status action (SA) SEND (0), HOLD (1), 
DISCARD (2) 
Store backspace character (SBC) : Yes (1), no (0) 
Store nuls dels (SND) ' Yes (1), no (0)_ 
& Terminal model (T™) ‘ - Any 1-25 characters 


Transparent character mode (TCM) : weak NONE (0), 
TERMINATE (1), 
FORWARD (2), 
FORWARD 
AND TERMINATE (3) 


Transparent forward character (TFC) : 1-4 characters 
Transparent length mode (TLM) ; , - NONE (0), 
_ TERMINATE (1), 
FORWARD (2), 
FORWARD EXACT (3) 
Transparent message length (TML) : 1-32, 767 


Transparent terminate character (TTC) ‘| 1-4 characters 


Transparent timeout mode (TT) ; . NONE. (0), 
TERMINATE (1), 


| FORWARD (2) 
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0015—Executive Auto Input 


This byte is used for internal auto input mode. It is reserved by NOS and should not be 
used since it may cause loss of data. 


0016—Terminal Redefinition for NAM/CCP 


This byte enables you to alter the characteristics of a terminal that is connected via IAF. 
The byte begins a string of 12-bit parameter/12-bit value pairs. The upper bit of each 
12-bit segment must be set to prevent a zero value from being interpreted as an 
end-of-line. The 0016 byte string must be terminated by an end-of-line. 


Table 12-2 lists terminal attributes and values allowed for each set of terminal classes. 
Refer to table 12-3 for mapping between NAM/CCP terminal attributes and the corresponding 
NAM/CDCNET terminal attributes. For default values for each terminal class, refer to Volume 
3, System Commands. Refer to appendix A for the translation of ASCII characters. 


‘ 


Up to 18 terminal characteristic values can be changed by a single 0016 byte string. For 
example, to change the page width to 100 (144g), control character to %, and turn the page 
wait option on, issue the following string. 

0016 4043 4144 4050 4045 4045 4001 0000 0000 0000 = 


In the preceding example, each byte has the indicated meaning: 


0016 Terminal redefinition control byte. 
4043 Specifies page width parameter (43g). 
| 4144 Sets page width to 100 (144g). 
| 4050 Spatities contest character parameter (50g). 
4045 Sets control character to % (45g). 
4045 Specifies page wait parameter (45g). 
4001 Sets page wait on (1 equals yes). 
00...00 ‘End-of-1line (terminates terminal redefinition control byte). 


For a complete description of terminal characteristics, refer to Volume 3, System Commands. 
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Table 12-2. 


Attribute (Mnemonic) . 


Abort block (AB) 


Blocking factor (BF) 

Break as user break 1 (BR) 
Backspace character (BS) 
Interruption character (B1) 
Termination character (B2) 


Enable transparent user 
break commands ~ 


Carriage return idle count 
(cI) 


Carriage return idle default 
(CA) 


Carriage return idle time 
(CRI) 

Cancel character. (CN) 
Cursor positioning (CP) 
Network control character 


(CT) 


Single message transparent 


‘ input delimiters (DL) 


Numbers in parentheses in this column indicate terminal 


-is ignored. . 


Attribute 
Number 
(Octal) 


Value 
Range 


Terai . 
(Decimal) 


Classes: 
1-8 ,28-31(9-18)2 
1-8,10-13,15,18 
(9,14,16,17) 


1-3,5-8, 28-31 
(4,9-18) 


1~8, 28-31(9-18) 


' 


| 1-15,18,28-31 
| (16,17) 


1-15,18, 28-31" 
(16,17) 


1-8,10-13,15 


1-8, 28-31(9-18) 


1-8, 28-31(9-18) 


1-8 ,28-31(9-18) 


1-15,18,28-31 
(16,17) 


1-3 ,5-8, 28-31 
(4,9-18) 


1-18, 28-31 


1-8 , 28-31(9-18) 


Ignored for packet-switching network (PSN) terminals. 


Any hexadecimal value except 00 - 02, 20, 30 - 39, 3D, 41 - 5A, 61 - 
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Form of 
Input 


Numerical yalue for 
character 


Decimal number -° 


Yes (1), no (0): 


Numerical yalue for. 
character ‘ 


Numerical yalue for 
character 


Numerical 7 gue for 
character 
Yes (1), no (0) 


Decimal number 


CA (1) 


Numerical value 


indicating the 
delay time in four 
millisecond 
increments 


Numerical valu 
for character 


Yes (1), no (0) 


Numerical ae for 
character 


Character specified 
(1), not specified 
(0) ° 


classes for which the attribute 


7A, or 7F. 


If the value of one of the fields for this parameter is changed, the values of all 
other fields for this parameter must also be specified. 
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Table 12-2. NAM/CCP Terminal Redefinition Attributes (Sheet 2 of 4) 


Attribute Value 
Number Terminal, Range Form of 
Attribute (Mnemonic) (Octal) | Classes (Decimal) Input 
Transparent message 71 1-3 ,5-8, 28-31 0 - 15 Character count 
length upper (DL) (9-18) (upper byte) 
Transparent message 72 1-3 ,5~8, 28-31 0 - 255 Character count 
length lower (DL) (9-18) (lower byte) 
Transparent message 73 1-8,10-13,15,18, 0 - 255 @ Numerical aeiie for 
character delimiter (DL) 28-31(9,14,16,17) character 
Transparent timeout 74 1-3 ,5-8, 28-31 o-1 ‘Timeout (1), no 
mode (DL) (9~18) timeout (0) 
Multiple-message mode (DL) 106. 1-8,10~13,15,18, 0 Single message (0) 
28-31 
End-of-block character (EB) 100 1-3,5-8,10-13, 0 - 255 @ Numerics? yo for 
15,18, 28-31 character 
End-of-block option (EBO) 101 1-3,5-8,10-13, 1- 2@ EL (1); EB (2) 
15,18, 28-31 . 
Cursor positioning at 102 1-3,5-8,10-13,15, 0- 3 @ NO (0), CR (1), 
end-of~-block (CPEB) 18, 28-31 LF (2), CL (3) 
(9,14,16,17,18) 
End-of-line character (EL) 75 1-3,5-8,10-13,15, | 0 - 127@ | numerical yalue for 
: 18, 28-31 character 
End-of-line option (ELO) 76 1-3,5-8,10-13,15, 1-2 EL (1), EB (2) 
18, 28-31 
Cursor positioning at 77 1-3,5-8,10-13,15, 0 - 32 NO (0), CR (1), 
end-of-line (CPEL) 28-31 LF (2), CL (3) 
(9,14,16,17,18) 
Echoplex mode (EP) 61 1-3 ,5-8, 28-31 o-1 Yes (1), no (0) 
(4,9-18) 
| Full ASCII input (FA) 67 1-8,10-13,15-18, oO 4 Yes (1), no (0) 
| ; 28-31 
| Input control (IC) 103 1-3,5-8, 28-31 0-1 Yes (1), no (0) 
(4,9-18) 
Transparent input mode 64 1-8,10-13,15,28-31] 0 - 1 Transparent input 


(XPT) (1), not transparent 


(0) 


-| @ Numbers in parentheses in this column indicate terminal classes for which the attribute 
; is ignored. 

@ Not all values are valid for all terminal classes. 

@ Any hexadecimal value except 00-02, 20, 30-39, 3D, 41-5A, 61-7A, or 7F. 
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Table 12-2. 


Attribute (Mnemonic) 


Input device (IN) 


Line feed idle count (LI) 


Line feed idle default 


Line feed idle time (LFI) 


Lockout unsolicited 
messages (LK) 


Multiple-message ® 
transparent delimiters 
(XL) ‘ 


Transparent message 
length upper (XL) 


Transparent message 
length lower (XL) 


Transparent message 
character delimiter ' 


Transparent timeout 
mode (XL) 


Multiple-message mode 
(XL) 


Out put control (OCy 


Output device (OP) 


Parity processing (PA) 


Numbers in parentheses in this column indicate terminal 


is ignored. 


Not all values are valid for all terminal classes. 
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Attribute 
Number 
(Octal) 


Terminal 
Classes 


1-8, 28-31 


1-8, 28-31(9-18) 
1-8, 28-31(9-18) 


1-8 ,28-31(9-18) 


1-15,18, 28-31 
(16) 


1-8 ,28-31(9-18) 


1-3,5-8, 28-31 
(9-18) 


1-3,5-8, 28-31 
(9-18) ; 


1-8,10-13,15,18, 
28-31(9, 14,16). 


1-3 ,5-8, 28-31 
(9-18) 


1-8,10,13,15, 
28-31 


1-3 ,5-8, 28-31 
(4,9-18) : 


1-8, 28-31(9-18) 


1-3,5-8, 28-31 


Value 
Range 
(Decimal) 


If the value of one of the fields for this parameter is changed, 
fields for this parameter must also. be specified. 


Any hexadecimal value except 00 - 02, 20, 30 - 39, 3D, ‘41 - 5A, 61 - 
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KB°(0), PT (1), 
BK (2) 


Decimal number 
LA (1) 

Numerical value 
indicating the 
delay time in 
four millisecond 


increments 


Yes (1), no (0) 


Character specified 


. (), not specified 


(0) 


Character count 
(upper byte) 


Character count 
(lower byte) 


Numerical yalue for 
character 


Timeout (1) 
no timeout (0) 


Multiple-message (1) 
Yes (1), no (0) 


DI (0), PR (1), 
PT (2) 


z (0), 0 (1), 
E (2), N (3), I (4) 


classes for which the attribute 


the values of all other 


7A, or 7F. 
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Table 12-2. NAM/CCP Terminal Redefinition Attributes (Sheet 4 of 4) 


Attribute (Mnemonic) 


Page waiting (PG) 


Page length (PL) 


Page width (PW) 


Site-defined use 


Special editing mode (SE) 
Terminal class (TC) 


Transparent mode character 
delimiter (XL) 


Sticky timeout (XL) 


Transmission block size 
upper (XBZ1) 


Transmission block size 
lower (XBZ2) 


Upline block limit 
Full duplex (FDLX) 
Set terminal in 


solicited input 
mode (NTA) 


Numbers in parentheses in this column indicate terminal 


is ignored. 


Attribute 
Number 
(Octal) 


Value 
Terminal Range 
Classes © 


1-8, 10-13, 15,18, 
28-31(9,14,16,17) 
1-18, 28-31 


1-18, 28-31 


1-18, 28-31 


1-8 ,28-31(9-18) 


1-10, 28-31 @ 


1-8, 18-31 
(9-18) 


1-3, 5-8, 28-31, 
(9-18) 
1-18, 28-31 @ 


1-18,28-31 @ 


1-18 


1-3, 5-8, 28-31 
(4,9-18) 


1-8,10-13,15, 
18, 28-31 


Not all values are valid for all terminal classes.. 


Not allowed for CDC-defined X.25 packet assembly/disassembly (PAD) terminals. 


(Decimal) 


Yes (1), no (0) 


Number of physical 


lines 


Number of characters 


Site-defined 


Yes (1), no (0) 


Number of new class 


Numerical oo for 


character 


Forward on timeout 
(1), do not forward 


on timeout (0) 


Decimal number 
(upper byte) 


Decimal number 
(lower byte) 


Decimal number 


Yes (1), no (0) 


Yes (1), no (0) 


classes for which the attribute 


terminal class (TC) changes, refer to the NAM/CCP Host Applications Programming 


Reference Manual. 


Any hexadecimal value except 00 - 02, 20, 30 - 39, 3D, 41 - 5A, 61 - 7A, or 7F. 
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For 


‘Mapping Between Terminal Attributes for NAM/CCP and NAM/CDCNET 


Table 12-3 lists the terminal attributes for NAM/CCP that have corresponding terminal 
attributes for NAM/CDCNET and shows the mapping from NAM/CCP to NAM/CDCNET. 


Table 12-3. Terminal Attribute Mapping from NAM/CCP to NAM/CDCNET (Sheet 1 of 3) | 


NAM/CCP Attributes NAM/CDCNET Attributes 


Number Number 
(Octal) Mnemonic=Value Mnemonic=Value (Octal) 


PCF=TRUE 
PCF=FALSE 
IBS=100 

: PCF=FALSE 

IBS=200 


SA=SEND 
SA=DISCARD 


HP=FALSE 
HP=TRUE 


CI=number CRD= number * line 
; speed factor 


14 


= 


_ 


Ww 
> 


121 


wn 
wn 


CLC=CAN 
SBC=FALSE 

EPC=LF 2 ay 
CLC=NUL 

SBC=TRUE 

EPC=NUL 


a 
_ 


62 
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Table 12-3. Terminal Attribute Mapping from NAM/CCP to NAM/CDCNET (Sheet 2 of 3) 


Number Number 
(Octal) = (Octal) 


ITEM=TRANSPARENT 


FL=FALSE 
FL=TRUE 
none 


EPC=LF 
SBC=FALSE 
SND=F ALSE 
EPC=NUL 
SBC=TRUE 
SND=TRUE 


XL)=0 TCM=NONE 

XL)=1 TCM=TERMINATE 

number 106=0) 

XL)=1 TCM=FORWARD TERMINATE 
number 106=1) ae 


XL) not specified and TLM=NONE 
number 72 not specified 
DL (or XL) specified and TML=value of numbers 72+256* 
number 72 specified (value of number 71) 


XL) not specified and TLM=NONE 
number 71 not specified 
DL (or XL) specified and TML=value of numbers 72+256* 
number 71 specified (value of number 71) 


XL) specified TFC=value of number 73 
XL) specified as CR TFC=(4 16,8446) 
and terminal parity=IGNORE 


DL(or XL)=0 ; TTM=NONE 
DL(or XL)=1 and number 106 TTM=TERMINATE 
or number 222=0 


DL(or XL)=1 and number 106 TTM=FORWARD 
and number 222=1 


77 , ELP=NONE 
ELP=CRS 
ELP=LFS 

ELP=CRLFS 
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Table 12-3. Terminal Attribute Mapping from NAM/CCP to NAM/CDCNET (Sheet 3-of 3) 


NAM/CCP Attributes : NAM/CDCNET Attributes 
Number : Number 
(Octal) Mnemonic=Value ’Mnemonic=Value (Octal) 
103 = CFC=FALSE 126 
= CFC=TRUE 


TTC=value of number 105 
TTC=(4 46,8416) 


XL specified 
XL specified as CR and 
terminal parity=IGNORE 


DL(or XL)=0 
DL(or XL)=1 and number 73 
specified but number 105 
not specified 

DL(or XL)=1 and TML=1 
DL(or XL)=l1 and TML=1 


TLM=TERMINATE 
TTIC=TFC 


TLM=FORWARD 
TLM=FORWARD EXACT 


ELP=NONE 
EPP=NONE 
ELP=LFS 
EPP=CRS 


127 FDLX=0 ; IOM=SOLICITED 
: FDLX=1 IOM=FULLDUPLEX 
160 NTA=0 IOM=UNSOLICITED 
; IOM=SOLICITED 
222 number 74=0 TTM=NONE 


number 222=]1 and number 74=1 
and number 106=1 

number 74=1 and either 
number 106=0 or number 222=0 


TIM=FORWARD 


TTM=TERMINATE 


CRi=number CRD=number*4 


‘LFI=number LFD=number*4 
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~ CONTROL OF PROGRAM EXECUTION 


Program execution control sequences vary. depending on the type of network. The following 
description applies only to the NAM/CCP network. CDCNET program execution control sequences 
are documented in the CDCNET Terminal Interface Usage manual. : 


By entering various sequences of keys or commands at your terminal, you can control an 
interactive program during all phases of execution. The following is a list of the 
interruption and termination sequences and their effect on.the executing program (the €) 
denotes the message terminator key). 


Phase Sequencet Effect 
Waiting CTRL/T € The program is terminated and the terminal is placed in. 
for input _-command mode. All other entries are passed to the 


program as data. 


Generating -. BREAK Pressing the BREAK key on asynchronous terminals suspends 
output. seq ; the output operation. For synchronous terminals, output 
, : is automatically suspended on page boundaries, at which 

point terminal control can be attempted. 


On asynchronous terminals, output can 
be suspended by pressing any key 

that transmits a character. The 
character entered is also sent to 

IAF if a or line feed is entered. 
The integrity of this character is 
not guaranteed, and may cause the 
interruption sequence which follows 
to be ignored. It is recommended 
that the BREAK key be used to suspend 
output. ; 


{The termination (sometimes referred to as user break 2) sequence (that. is, CTRL/T€®) and 


interruption (sometimes referred to as user break 1) sequence: (that is, CTRL/P@A) may vary 
for different terminals, and may be changed by terminal definition commands. . Refer to 
Volume 3, System Commands, for further information. CTRL refers to the control key. 

Thus, CTRL/T is entered by keeping the control key depressed while pressing the T key. 
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Phase Sequencef Effect 


Once output is suspended, further execution depends upon 
the subsequent sequence of keys or characters entered. 
Each of the following sequences has the indicated effect 
on the output operation. 


seq . Effect 


CTRL/T €®) This has the same effect as the 
termination sequence in the input 
phase. 


CTRL/PEATT The output operation ceases and the 
terminal is placed in suspend mode. 


At this point IAF recognizes only: , @ 


e The P key causing a return to — 
program control, discarding 
any data in the program 
buffer prior to the 
interruption sequence. 


e A €®) causing output to be 
continued and program control 
to continue normally. 


Portions of the output may be 

lost when output is suspended. : 
e Any other key (with the 

exception of terminal control 

characters and terminal 

definition commands) is 


interpreted as a request to 
terminate the job step. 


If any other sequence of characters or keys is entered 


followed by a » the output operation is resumed with 
the last partial line repeated. 


Executing . CTRL/T €®) These have the same effect as if they were entered during 


or output phase. 
CTRL/P 


t The termination (sometimes referred to as user break 2) sequence (that is, CTRL/T€A) and 
interruption (sometimes referred to as user break 1) sequence (that is, CTRL/P€A) may 
vary for different terminals and may be changed by terminal definition commands. Refer 
to Volume 3, System Commands, for further information. CTRL refers to the control key. 
Thus, CTRL/T is entered by keeping the control key depressed while pressing the T key. 

TTIf the BR terminal redefinition parameter has been set to 1 or if the terminal definition 
command cBR=Y or TRMDEF,BR=Y has been entered, the BREAK key has the same effect as 
CTRL/ PEA. 
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REPRIEVE PROCESSING FOR USER BREAKS 1 AND 2 


If the user program has selected terminal interrupt reprieve processing, control will be 
passed to the user“s interrupt package when a user break 1 or 2 is encountered. The user 
program may now process the interrupt as desired. 


' To ignore either interrupt, a REPRIEVE RESUME call may be used. This will restart the. 


interrupted sequence as if the interrupt had never occurred. 


If the user wishes to have the system process the user break 2, a REPRIEVE RESET call will 
return control to the system, and the interrupt will be processed in the normal manner. 


The user break'1 interrupt. cannot be returned to the system by a RESET call. 
If the user desires the sequence 
*INTERRUPTED* (CR) 


that is normally associated with a user break 1, the sequence will have to be emulated in 
the user’s interrupt handler. 


60459690 F a 12-21 


CHARACTER SETS A 


, 


A character set is composed of graphic and control characters. ,A code set is a set of codes 
used to represent each character within a character set. - ; : . fae 


A graphic character may be displayed at a terminal or printed by a line printer. Examples 
are the characters A through Zand the digits O through 9. A control character initiates, . 
modifies, or stops a control operation. An example is. the backspace character that moves 
the terminal carriage or cursor back one space. Although a control character is not a 
graphic character, a teminal may produce a graphic representation when it receives a 
control character. ; 


All references within this manual to the ASCII character set or the ASCII code set refer to 
the character -set ani code set defined in the American National. Standard Code for 
Information Interchange (ASCII, ANSI Standard X3.4-1977). References in this manual to the 
ASCII character set do not necessarily refer to the ASCII code set. 
NOS supports the following character sets. 

e CDC graphic 64- (or 63-) character ‘set. 

e@ ASCII 128-character set. 

e ASCII graphic 64- (or 63-) character set. 

e ASCII graphic 95-character set. 
Each installation selects either the 64-character set or the 63-character set. ‘The 
differences between the two are described in Character Set Anomalies in this appendix. Any 
reference in this appendix to the 64-character set implies either the 63- or 64-character 
set, unless otherwise stated. 
NOS supports the following code sets. 

e 6~bit display code. 

e 6/12-bit display code. 

e@ 77-bit ASCII code. 
Display code is a set of 6-bit codes from 00g to 77g. 
The 6/12-bit display code is a combination of 6-bit codes and 12-bit codes. The 6-bit codes 
are 00g through 77g, excluding 74g and 76g. (Refer to Character Set Anomalies for 
the interpretation of the 00g and 63g codes.) The 12-bit codes begin with either 748 
or 76g and are followed by a 6-bit code. hus, 74g and 76g are considered escape 
codes ami are never used as 6-bit codes within. the 6/12-bit display code set. The 12-bit 


codes are 7401g, 74023, 74043, 7407g, and 760lg through 7677g. All other 12-bit 
codes (74xxg and 7600g) are undefined. — 
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The 7~bit ASCII code (as defined by ANSI. Standard X3.4-1977) is right-justified in a 12-bit 
byte. Assuming that the bits are numbered from the right starting with 0, bits 0 through 6 
contain the ASCII code, bits.7 through 10 contain zeros, and bit 11 distinguishes the 


0000g code from the end-of-line byte. The 7-bit codes are 0001g through 0177g and 
4000g. 


CHARACTER SET ANOMALIES 


NOS interprets two codes differently when the installation selects the 63~character set 
rather than the 64-character set. In tables A-l, A-2, and A-3, the codes for the colon and 
percent graphic characters in the 64-character set are unshaded; the codes for the colon and 
percent graphic characters in the 63-character set are shaded. — 


If an installation uses the 63-character set, the colon graphic character is always 
represented by a 63g code, and the 00g code is undefined.. However, if the installation 
uses the 64-character set, output of 6/12-bit display codes 74049 or 6-bit display code 
00g produces a colon. In ASCII mode for interactive jobs, a colon can be input only as a 
7404, 6/12-bit display code. 


When using either the 63- or 64-character set, the use of undefined 6/12-bit display codes 
in output files produces unpredictable results and should be avoided. 


On input, NOS recognizes alternate 029 punch codes of 11-0 for the right bracket (]) and 
12-0 for the left bracket ([). The alternate codes support the COBOL sign overpunch 
convention and are not recommended for other uses. Refer to COBOL 5 Reference Manual. 


Also, two 00g codes may be confused with an end-of-line byte and should be avoided (refer 
to appendix F for further explanation). 


Translation of 7-bit ASCII to 6-bit display code causes character set folding from the 
128-character ASCII set to the 63- or 64-character ASCII subset. The following special 
character substitutions occur: 


7-Bit ASCII 6-Bit Display Code 7-Bit ASCII 
Code Character Code Character Code __ Character 
0140 a 74 @ 0100 @ 
0173 { sie 0133 
0174 [oo sewer en--> 75 \ 0 secre een- > 0134 . \ : * 
0175 } 62 J 0135 ] 
0176 ~ ; 76 * 0136 * 


CHARACTER SET TABLES 


This appendix contains character set tables for interactive jobs, batch jobs, and jobs. 
involving magnetic tapes. Table A-] is for interactive jobs, and table A-2 is for batch 
jobs. Table A-3 is a conversion table used to cross-reference 7-bit ASCII codes and 
6/12-bit display codes and to convert ASCII codes from octal to hexadecimal. 
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Tables A-4, A-5, and A-6 list the magnetic tape codes and their display ode equivalents. 


The character set tables are designed so that you can find the character represented by a 
code (such as in a dump) or find the code that represents a character. To find the 
character represented by a code, look up the code in the column listing the appropriate. code 
set and then find the character on that line in the column listing the appropriate character 
set. To find the code that represents a character, you first look up the character and then 
find the code on the same line in the appropriate column. 


“INTERACTIVE JOBS 


Table A-1 shows the character sets and code sets available to you at an ASCII code 


’ terminal. When in NORMAL mode (specified by the NORMAL commandf), NOS displays the -ASCII 


graphic 64-character set and interprets all input and output as 6-bit display code. When in 
ASCII mode (specified by the. ASCII command), NOS displays the ASCIT 128-character set and 
PRPEERESES all input and SurpUS as 6/12- bit display code. 


To determine the octal or hexadecimal ASCII code for a character, refer to table A-3. 
(Certain terminal definition commands require specification of an ASCII code.) 


On output, the US code is reserved for network use and defined as an end-of-line. Use of 
this character, except in transparent mode, causes incorrect formatting and ‘possible loss of 
output characters. 


BATCH JOBS 


Table A-2 lists the CDC graphic 64-character set, the ASCII graphic 64-character set, and 
the ASCII graphic 95-character sets. It also lists the code sets and card punch codes (026 
and 029) that represent the characters. 


The 64-character sets use display code as their code set; the 95-character set uses 7-bit 
ASCII code. ‘The 95-character set is composed of all the characters in the ASCII 
128-character set that can be printed at a line printer (refer to jobs using Line Printers). 
Only 7-bit ASCII code files can be printed using the ASCII graphic 95-character set. To 
print a 6/12-bit display code file (usually created by an interactive job in ASCII mode), 
you must convert the file to 7-bit ASCII code. To do this, you enter the. FCOPY command. 

The 95-character. set is represented by 7-bit ASCII codes 0040g through 0176. 


JOBS USING LINE PRINTERS 


The batch character set printed depends on the print train used on the line printer to which 
the file is sent (refer to section 7). The following table lists the print trains according 
to the associated ROUTE command EC’ parameter values. . 


ft Normal and ASCII modes can also be selected via the CSET COMPASS macro. 
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Print Route EC Values Route EC Value That Suggested 
Train That Will Print Will Not Print Print Band 


AA, 


595-1/596-1 


A4, 


595-1/596-1 
A4, 


595-1/596-1 


A4, 595-1/596-1 


B4, 


595-6/596-6 


B4, 


595~-4/596-4 
or 
595-5/596-5 


None, B4, B6, A4, A6 595-6/596-6 


B4, B6, A4, Ab, AY 


595-6/596-6 


{These print trains are reserved for future CDC use. 


If specified, they have the same : 
effect as if print train 7 was specified. 


For PSU printers, the batch character sets and associated print trains are as follows: 


Character Set. 533/536 Print Trains 
ASCII graphic 64-character set 530-1 
ASCII graphic 95-character set 530-2 


The characters of the default 596-1 print train are listed in the table A-2 column labeled 
CDC Graphic (64 Character); the 596-5 print train characters are listed in the table A-2 
column labeled ASCII Graphic (64 Character); and the 596-6 print train characters are listed 
in the table A-2 column labeled ASCII Graphic (95 Character). 


If a transmission error occurs when. printing a line, the system prints the line again. The 
CDC graphic print train prints a concatenation symbol (1) in the first printable column of 


the repeated listing of the line. The ASCII print trains print an underline (_) instead of 
the concatenation symbol. 


If an unprintable character exists in‘a line (that is, a 7-bit ASCII code outside the range 


0040g through 01763), the number sign (#) appears in the first printable column of a 
print line, and a space replaces the unprintable character. 


To route and correctly print a 6/12-bit display code file on a line printer with the ASCII 
graphic 95-character set, you must convert the 6/12-bit display code file to a 7-bit ASCII 
code file with the FCOPY command (refer to section 9).° The resulting 7-bit ASCII file can 


be routed to a line printer (refer to.section 7) but cannot be output at an interactive . 
terminal. 
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Table A~1. Character Sets for Interactive. Jobs (Sheet'1 of 2) 


ASCIE ASCIL “ ASCII ASCII 
Graphic : Character Graphic Character 
(64 Character) 4 (128 Character) (64 Character) (128 Character) 


# number sign number sign 
[ opening bracket opening bracket’ 
] closing bracket closing bracket 


0102 X% percent sign ercent sign 
o1os | sgseega srs LaBERthaetestag aa SS 
0104 

0105 _ underline underline 


0106 ! exclamation point T exclamation point 
0107 ampersand ampersand 


Fe 
2B 
= 
Peas 


AOnmMCOOWD 


apostrophe apostrophe 
0110 ? question mark ? question mark 
oll less than less than 
0112 greater than greater than 
0113 commercial at commercial at 
0114 reverse slant Teverse slant 
0115 : circumflex circumflex 
0116 3; semicolon 3 semicolon 
O17 ke , 


O2zzFrnAGHs 
OCZRMrRAGHEZ 


0120 SS oS % 
0121 : ‘ grave accent 
0122 
0123 
0124 
| 0125 
0126 
0127 


eaecHnnwmonv 
Ze cHnwonv 


emreanagen 


0130 
0131 
0132 
0060 
0061 
0062 
0063 
0064 


fFwWwNe ON KK 
PWN RON KM 


Os BrErUPrs 


0065 
0066 
0067 
0070 
0071 
plus 0053 
dash 0055 
asterisk 0052 


plus 
dash 
asterisk 


ete tODn TAN 
e+ 1 $F OOrnHTAu 
Ec cna ov 


slant slant . 0057 
opening parenthesis opening parenthesis 0050 
closing parenthesis closing parenthesis| 0051 
dollar sign : dollar sign 0044 { opening brace 
equal equal 0075 | vertical line 
space space . | 0040 . } closing brace 
comma comma 0054 ~ tilde 

period period 0056 DEL 


NMG x 


trhe interpretation of this character or code may depend on its context. Refer to Character Set Anomalies elsewhere in this appendix. 
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Table A-1. Character Sets for Interactive Jobs (Sheet 2 of 2) 


ASCII ASCII ASCII ASCII 
Graphic Character Display | Display Graphic Character 
(64 Character) (128 Character) (64 Character) (128 Character) 


ftReserved for network use. Refer to Character Set Tables in this appendix. 
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Table A-2. Character Sets for Batch Jobs (Sheet 1 of 3) 


coc "ASCII ; ASCII 
Graphic - . Graphic Graphic 
(64 Character) (64 Character) (95 Character) 


O39 MOO De 
3 


SM CHNRPOVD CARO KRGH ED AmMmoOaw 
BScmcnnwrmow OS2KFOrAGH SE 
EBM GANRPOV OSE r KROGH DZ QOMmvAwW 


FWNPON «M 
FwWnNRKON Kw 
FWNKON «KM 


OD IAW 
WOnnu 


i+ 
au 
oe 
ane 
ae] 

1+ 
ag 
ore 
ne 
fom) 


* asterisk * asterisk * asterisk 


TThe interpretation of this character or code may depend on its context. Refer to Character Set Anomalies 
elsewhere in this appendix. : : : 
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new es Ill 


>< tH 


A 
v 
< 
> 
< 
2 


cpc 
Graphic 
(64 Character) 


slant 

opening parenthesis 
closing parenthesis 
dollar sign 

equal 

space 

comma 

period 


equivalence 
opening bracket 
closing bracket 
percent signf 


not equal 
concatenation 
logical OR 
logical AND 


superscript 
subscript 

less than 
greater than 
less or equal 
greater or equal 
logical NOT 
semicolon 


TThe interpretation of this character or code may depend on its context. 


ASCII 
Graphic 
(64 Character) 


slant 

opening parenthesis 
closing parenthesis 
‘dollar sign 

equal 

space 

comma 

period 


number sign 
opening bracket 
closing bracket 
percent signt 


quote — 
underline 


! exclamation point 
ampersand 


apostrophe 


? question mark 


less than 
greater than 
commercial at 
reverse slant 
circunf lex 
semicolon 


elsewhere in this appendix. 


ASCII 
Graphic 
(95 Character) 


slant 

opening parenthesis 
closing parenthesis 
dollar sign 

equal 

space 

comma 

period 


number sign 
opening bracket 
closing bracket 
percent signf 


quote 
underline 


! exclamation point 
& ampersand 


apostrophe 


? question mark 


less than 
greater than 


reverse slant 
semicolon 


commercial at 
circumflex 


Table A-2. Character Sets. for Batch Jobs (Sheet 2 of 3) 


6/12-Bit|7-Bit 
Punch Code 


029 


0-1 0-1 
0-8-4 12-8-5 
12-8-4 11-8-5 
11-8-3 11-8-3 
8-3 8-6 
no punch | no punch 

0-8-3 

12-8-3 


Refer to Character Set Anomalies 
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Table A-2. Character Sets for Batch Jobs (Sheet 3 of 3) 


~ cpe ASCII ASCII 6/12-Bit| 7-Bit 
Graphic Graphic Graphic ; Display|Display | ASCII Punch Code . 


(64 Character) (64 Character) (95: Character) | . | Code 


on Be wuU.s 


edcenrnrnrav 


x 
y 
z 


{ opening brace 
{| vertical line 


} closing brace 
, ~ tilde 


{The interpretation of this: character or code may depend on its context. Refer to Character Set Anomalies 
elsewhere in this appendix. 
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“Table A-3. ASCII to 6/12-Bit Display Code Conversion (Sheet 1 of 2) ° 


Character ASCII Code Display Character ASCII Code 
(128 Character) Code (128 Character). Hexadecinal 


Hexadecimal 


NAULSWNHeE CO 


wo 


less than 
equal 

greater than 
question mark 


wv iay 


commercial at 


QMO AW, we 


OZRMAYNHE 


! exclamation point 
quote 

# number sign 

$ dollar sign 

% percent signtt 


ampersand 
apostrophe 


HZ<ccHnnwrow 


( opening parenthesis X 

) closing parenthesis Y 

* asterisk Z 

+ plus { opening bracket 

» comma \ reverse slant 

~ dash ] closing bracket 

+ period * circumflex 
underline 


slant 


tReserved for network use. Refer to Character Set Tables in this appendix. 
TtThe interpretation of this character or code may depend on its context. Refer to Character Set Anomalies in 
this appendix. 
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Table A-3. ASCII to 6/12-Bit Display Code Conversion (Sheet 2 of 2) 


‘ASCII 
Character 
(128 Character) 


* grave accent 


a 
b 
c 
d 
e 
f 
g 
h 
i 
j 
k 
1 
m 
n 
° 
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_ 7-Bit 
"ASCII Code 


Hexadecimal 
60 


6/12-Bit 
Display 
Code 


Character ASCII Code Display 


(128 Character) Hexadecimal Code 
70 


€edcranays 


NS 


{ opening brace 
| vertical line 
} closing brace 
~ tilde 

DEL : 
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JOBS USING MAGNETIC TAPE 


Coded data to be copied from mass storage to magnetic tape is assumed to be represented in 
display code. NOS converts the data to external BCD code when writing a coded seven-track 


tape and to ASCII or EBCDIC code (as specified on the tape assignment command) when writing 
a coded nine-track tape. 


Because only 63 characters can be represented in seven-track even parity, one of the 64 
display codes is lost in conversion to and from external BCD code. The following shows the 
differences in conversion depending on the character set (63 or 64) which the system uses. 
The ASCII character for the specified character code is shown in parentheses. The output 
arrow shows how the 6-bit display code changes when it is written on tape in external BCD. 
The input arrow shows how the external BCD code changes when the tape is read and converted 
to 6-bit display code. 


63-Character Set 


6-Bit Display Code External BCD .  6-Bit Display Code 
00 "i . 16 (%) 00 
-33 (0) Output 12 (0) Input 33 (0) 
63 (3) 12 (0) 33 (0) 


64-Character Set 


6-Bit Display Code : External BCD 6-Bit Display Code 
00 (:) 12 (0) 33 (0) 
33 (0) Output 12 (0) Input 33 (0) 
63 (4%) 16 (%) 63 (4%) 


If a lowercase ASCII or EBCDIC code is read from a nine-track coded tape, it is converted to 
its uppercase 6-bit display code equivalent. To read and write lowercase ASCII or EBCDIC 
characters, you must assign the tape in binary mode and use the FCOPY ‘eatery. (refer to 
Volume 3, System Commands). 


Tables A-4 and A-5 show the character set conversion for nine-track tapes. Table A-4 lists .. 
the conversions to and from the 7-bit ASCII character code and 6-bit display code. Table 
A-5 lists the conversions between the EBCDIC character code and the 6-bit display code. 
Table A-6 shows the character set conversions between external BCD and 6-bit display code 
for seven-track tapes. 
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Table A-4. Nine-Track ASCII Coded Tape Conversion’ 


6-Bit : , 6-Bit 


Display _ Display 
7-Bit ASCII Code 7-bit ASCII ' Code 


Code Code Code Code . Code 
(Hex)| Chart (Hex) Chartt Char ey (Hex) | Charf (Hex) peace Char. (Octal) 


n 


>. 
? 
-@ 
A a 
B b 
Cc c 
D d 
E e 
F f 
G 8 
H h 
I i 
J j 
K k 
L 1 
-M mn 
N. n 
0 ° 
P P 
Q q 
R r 
s s 
T t 
‘U u 
Vv Vv 
W w 
xX x 
7Y y 
- 2 z 
-[ F 
\ ! 
j 


IEF ENK KES CHNMDOVOZEMAGHTAAMGDAD>SANV 


n 
° 
=x 


fWhen these characters are copied from/or to a tape, the characters remain the same but the codes change 


from one code set to the other. 


tfThese characters do not exist in 6-bit display codes Therefore, when the characters are copied from a 


tape, each 7-bit ASCII character is changed to an alternate 6-bit display code character. The 


corresponding codes are also changed. Example: When the system copies a lowercase a, 6116, from tape, 


it writes an uppercase A, Olg, 
TTTA 6-bit display code space always translates to a 7-bit ASCII space. 
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Table A-5. ‘Nine-Track EBCDIC Coded Tape Conversion 


| EBCDIC | 
Code Code 
(Hex) | CharT (Hex) | Char ft Char 
C4 84 


Code Code Code 
(Hex)| Charf | (Hex) | CharfT CharfT | (Octal) 
40 00 NUL ae 


space space 
4A ¢ ic IFS { 61 85 
4B F OE so ‘ 57 86 
< co { < 72 
( 16 BS ( 51 
+ OB VT + 45 
| DO } ! 66 
& 2E ACK & 67 
! 01 SOH ] 62 
$ 37 EOT $ 53 
* 25 LF x 47 
) 05 HT ) 52 
; 27 ESC ; 77 
- Al = - 76 


u 


g NS RE CEC RPH—HROVO DSK rUs WOH HHA 
Le] 
WOANAUEFWNHrRON KM ESCA NK BDOVOS ZFrAKAGH TOADMS 


WONDUNFWNHKON KM ERK CHAN- DROVOAZMAGH BOB MY 


when these characters are copied from/or to a tape, the characters remain the same (except EBCDIC codes 
4A, 4F, 5A, and 5F) but the codes change from one code set to the other. 

TtThese characters do not exist in 6-bit display code. Therefore, when the characters are copied from a 
tape, each EBCDIC character is changed to an alternate 6~bit display code character. The corresponding 
codes are also changed. Example: When the system copies a lowercase a, 8l)6, from tape, it writes an 
uppercase A, Olg. 

Tttau EBCDIC codes not listed translate to 6-bit display code 55g (space). A 6-bit display code space 
always translates to an EBCDIC space. 
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Table A-6. Seven-Track Coded Tape Conversions 


Ex ternal ASCII . 
BCD Character | (0c tal) 


IOwwmnnuUPrwne 
tne DOWOZ RrAY I 


2 
> 
+ 
A 
B 
C 
D 
ey 
F 
G 
H 
I 
< 
) 
\ 


TAs explained previously in this section, conversion 
of these codes depends on whether the tape is being 
read or written. 
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MESSAGES | B 


This appendix lists alphabetically the dayfile messages of interest to the COMPASS 
applications programmer. If you encounter a diagnostic or informative message that does not 
appear in this appendix, consult the NOS Version 2 Diagnostic Index, which catalogs all 
messages produced by NOS and it products and specifies the manual or manuals in which each 
message is fully documented. Refer to Volume 3, System Commands, appendix B, for messages 
pertaining to general job processing. 


In this appendix, lowercase characters are used to identify variable names or fields. All 
messages are sorted according to the first nonvariable word or character. Messages 
beginning with special characters (such as hyphens or asterisks) are sorted as if the 
special character(s) were not present. For example, the message 

filenam ALREADY PERMANENT, AT addr. 
is listed with the messages beginning with A, and the message 


x*x*k* ENDING SUPPORT OF LFM FUNCTION nnB. 


is listed with the messages beginning with E. 
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MESSAGE 


ACCESS CATEGORIES NOT VALID FOR JOB. 


ACCESS LEVEL NOT VALID FOR FILE. 


ACCESS LEVEL NOT VALID FOR JOB. 


ACCESS LEVEL NOT VALID ON PF DEVICE. 


ACCOUNT BLOCK LIMIT. 


ADORESS OUT OF RANGE. 


filename ALREADY PERMANENT. 


APPLICATION NAME IS REQUIRED. 


ARG. ERROR. 


ARITHMETIC INDEFINITE. 


ARITHMETIC OVERFLOW. 


ARITHMETIC UNDERFLOW. 


est, ASSIGNED TO filename. 


ttest, ASSIGNED TO filename. 


B-2 


SIGNIFICANCE 


You attempted to use the SETPFAC command 
or macro to set one or more permanent file 
access categories for which you are not 
validated. 


One of the following: 

- You attempted to save a local file 
using an access level for the 
permanent file that is not valid for 
the device on which the local file 
resides. 

- You attempted to define an existing 
local file as a direct access 
permanent file using an access Level 
for the permanent file that is not 
valid for the device on which the 
local file resides. 


One of the following: 

- You attempted to save a local file 
at an access Level that is not valid 
for your job. 

- You attempted to define an existing 
local file as a direct access 
permanent file at an access level 
that is not valid for your job. 

- You attempted to set an access level 
for a permanent file that is not 
valid for your job using the SETPFAL 
command or macro. 


On a SAVE, DEFINE, or SETPFAL command or 
macro, you specified an access level that 
is outside the range of access Levels 
allowed on your permanent file device. 


The monitor detected the expiration of the 
account block SRU Limit. 


An address in a parameter block is outside 
the job's field length. 


You have already saved or defined a file 
with the name specified. 


You entered an APPSW command that did not 
specify a secondary application. 


LDR parameters were outside your job's 
field length or the central memory address 
in call is not within your job's field 
length. 


The CPU floating-point arithmetic unit 
attempted to use an indefinite operand. 


The CPU floating-point arithmetic unit 
received an operand too Large for 
computation. 


The CPU floating-point arithmetic unit 
received an operand too smalt for 
computation. 


Informative message specifying EST ordinal 
assigned to file filename. * 


Equipment type tt with EST ordinal est was 
assigned to file filename. 


ACTION 


Retry using a set of 
access categories for 
which you are validated 
and that is valid for 
your job. 


Retry using an access 
level for the permanent 
file that is not lower 
than the access level of 
the local file. 


Retry using a valid access 


level. 


Inform security 
administrator that 

your permanent file 
device is not valid for 
all the access levels 
for which you are 
validated. 


Reset account block SRU 
Limit with SETASL 
command or macro. If 
the account block Limit 
is set at its maximum, 
issue another CHARGE 
command to begin a new 
account block. 


Specify parameter block 
address within field 
Length. 


Save or define file 
using different file 
name or purge existing 
file. 


Reenter the command with 
the appl parameter 
specified. 


Examine program to 
determine error. 


Analyze the job output 
and dumps to determine 
the cause. 


Analyze the job output 
and dumps to determine 
the cause. 
Analyze the job output 
and dumps to determine 
the cause. 


None. 


None. 


ROUTINE 


PFM 


PFM 


PFM 


PEM 


TAN 


LFM 


PFM 


TLX 


LDR 


4AS 


1AJ 


1AJ 


LFM 


LFM 
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MESSAGE 


jsm ASSIGNS EXCEED DEMANDS. 


ATTRIBUTE COMMANDS MUST BE OF ONE NETWORK 
TYPE. 


’ BAD CATALOG/PERMIT SECTOR. 


BLANK TAPE, filename AT address. 


. BLOCK SEQUENCE ERROR, filename AT address. 


BLOCK TOO LARGE, filename AT address. 


BOT/EOT ENCOUNTERED, filename AT address. 


BREAKPOINT CONDITION. 


BUFFER ARG. ERROR. 


BUFFER ARGUMENT ERROR, filename AT address. 


BUFFER CONTROL WORD sia filename AT 
address. 


BUFFER CONTROL WORD ERROR ON filename AT 
address. 


pfn BUSY. 
CHANNEL MALFUNCTION, filename AT address. 
CHECKPOINT nnnn COMPLETE. 


CHECKPOINT nnnn COMPLETED TO filename. 
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SIGNIFICANCE 


RESEX internal problems occurred. The 
resources actually assigned to the job with 
the specified job sequence name exceed the 
resources demanded on a RESOURC command. 


Terminal attributes unique to NAM/CCP and 
to NAM/COCNET were specified on the same 
TRMDEF command. 


PFM has encountered a catalog or permit 
sector which does not have a valid sector 
length. This indicates corruption of 
system areas on disk. 


A blank tape was read. Blank tape is 
defined as more than 25 feet of erased tape. 


The block Length recorded in the file did 
not match the Length of the block read, or 
the block number recorded in the file did 
not match the system block count (this 
message applies to I format tapes only). 


The tape being read contained a data block 
greater in size than. that allowed by the 
specified format or by your specification. 


Indicates an abnormal tape position. 


The job executed an address for which a 
breakpoint was requested by the system. 


CM address in call is not less than the 
field length minus the word count; buffer 
extends past the job's field Length. 


For tape operations, this message indicates 

one of the following: 

- FET less than 7 words long for S/L format 

- MLRS greater than 1000 octal for $ format 

- POSMF issued and no HDR1 Label found in 
FET or extended tabel buffer 


Either an attempt was made to write a block 
smaller than the noise size on an S, L, or 
F format tape, or a control word error 
occurred in a write (such as bad byte 
count). 


Block length specified on WRITECW operation 
exceeds the allowable physical record size 
for the device. 


The specified direct access file is 
currently attached in an incompatible 
mode, or is already being accessed by 
4095 users in your specified mode (R, 
RA, RU, or RM). 


A hardware malfunction occurred. 


Indicates that checkpoint nnnn has . 
completed. Issued if only one checkpoint 
file is present. 


Indicates that checkpoint nnnn has been 
completed to file filename. Issued if 
alternate CB checkpoint files are used. 


ACTION 


Rerun the job. If the 
problem recurs, inform 
a site analyst, write 
a PSR and include 
support material so 
that CDC can duplicate 
the problem. 


On the TRMDEF command, 
check to ensure that all 
terminal attributes are 
supported by your 
network type. 


Inform site analyst. 

If many of these ‘errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITIALIZE, 
and full PFLOAD on the 
device. 


Ensure correct tape is 
specified on command. 


Ensure accuracy of 
format parameter (F) on 
command or macro. 


Ensure accuracy of 
format parameter (F) on 
command or macro. 


Inform site analyst if 
persistent. 


Inform software support. 


Verify that operation 
does not reference 
address beyond end of 
buffer or job's field 
length. 


Examine program to 
determine error. 


Examine program to 
determine error. 


Correct the program that 
is formatting the data 
for the WRITECW 
Operation. 


Reissue ATTACH until 
file becomes available, 
or issue ATTACH 
specifying WB option. 


Inform site analyst. 


None. 


None. 


ROUTINE 


RESEX 


TRMDEF 


PFM 


IMT ~ 


AMT 


IMT 


AMT 
1AJ 


TAS 
Tcs 


MT 


1MT 


IMS 


PFM 


MT 


CHKPT 


CHKPT 
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MESSAGE 


CHECKPOINT FILE ACCESS LEVEL ERROR. 


CHKPT UNABLE TO READ TAPE. 


CIO ERROR nn ON filename. 


CIO ERROR. 


CKP REQUEST. 


CM BLOCK OUT OF RANGE, 


CM OR EC REQUEST EXCEEDS MAXIMUM. 


CM OUT OF RANGE. 


CM PARITY ERROR. 


CM RANGE EXIT MODE NOT DESELECTABLE. 


CMC PARITY ERROR. 


CONNECT REJECT, filename AT address. 


CONTENTS NOT CHECKPOINTED FOR FILE xxxxxxx 


CONTROL *QAC* ERROR nnn. 

CONTROLLED BACKSPACE ERROR, filename AT 
address. 

CPM - ACCESS LEVEL NOT VALID FOR JOB. 


CPM - ARGUMENT ERROR. 


SIGNIFICANCE 


In a secure system, the checkpoint file 
access Level is not the same as the job 
access level limit. This is to insure that 
the checkpoint file is secure enought to 
contain all local files. The access level 
of the checkpoint file is not changed to 
this level since this is not possible for 
Magnetic tape files or direct access 
permanent file, and these are the usual 
file types used for checkpoint files. 


Indicates a tape file had an unrecovered 
parity error when CHKPT tried to write it 
to the checkpoint file. 


A CIO error with octal error code nn 
occurred while RESEX was trying to open 
tape file filename. 


Updating of resource file returned error 
status other than end-of-device. 


A checkpoint has been initiated. 

Data transfer from extended memory 
specified a CM address outside the job 
field length. 


Field length of more than 77000 octat (CM) 


- of more than 7777 octal (EM) was specified 


in RFL command. 


The program referenced an address outside 
the job CM field Length. 


Double data parity error (two data bits 
failed) between central memory control 
(CMC) and CM as detected by the 
single-error correction double~error 
detection (SECDED) network, or a single 
parity error when operating in default mode 
(SECDED network disabled). 


You attempted to deselect system checking 
for CM out of range errors. This cannot be 
done on a model 176. 


The CPU sent the central memory control 
(CMC) data or an address having incorrect 
parity. 


The system was unable to connect a 
peripheral device. 


A CHECKPT macro call or a CKP RA+1 call was 
made and file xxxxxxx is a tape file 
appearing in the parameter List of the 
request. The manner in which the file was 
selected for processing was other than f=4 
(position information only). Since 
magnetic tapes are not copied to the 
checkpoint file, only the position 
information was copied (f=4 was forced). 
Thus, it will be necessary to assign the 
tape to the restart job. If the contents 
of the tape is destroyed, it may not be 
possible to restart the checkpoint job 
correctly. 


A system error was encountered while making 
a QAC monitor request. 


Controlled backspace operation failed 
during write error recovery. Position of 
tape is uncertain. 


You attempted to change the job access 
level to a value not valid for the job. 


An incorrect argument was specified. 


ACTION 


Insure that the access 
level of the checkpoint 
file is the same as the 
job access level upper 
limit. 


None. 


Use a different tape. 


Rerun the job. If the 
problem recurs, inform 
a site analyst, write 
a PSR and include support 
material so that CDC can 
duplicate the problem. 


None. 


Analyze the job output 
and dumps to determine 
the cause. 


Retry with lower value(s). 


Analyze job output and 
dumps to determine the 
cause. 


Inform customer engineer. 


Determine if the program 
can run with CM range 
error checking. If it 
cannot, the program must 
be changed. 


Inform customer engineer. 


Inform site analyst. 


Save the tape for the 
restart job without 
altering the tape 
contents from the time 
of the checkpoint. To 
eliminate the message, 
select f=4 for tape 
files. 


Write a PSR and include 
support materials to 
allow CDC to duplicate 
the problem. 


Inform customer engineer. 
Retry with a valid Level. 


Retry the command using 
valid arguments. 


ROUTINE 


CHKPT 


CHKPT 


RESEX 


RESEX 


CHKPT 


1AJ 


CONTROL 


1AJ 


TAS 


CPM 


TAS 


AMT 


RESTART 


CONTROL 


1MT 


CPM 


CPM 
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et 


CPM 


cpm 


CPM 


CPM 


CPM 


cpm 


CPM 


CPM 


CPM 


CPM 


CPU 


CVL 


MESSAGE 


- INCORRECT PACK NAME. 


- INCORRECT REQUEST. 


- INVALID PAGE VALUE. 


- LIBRARY NOT FOUND = Library. 


- MASS STORAGE ERROR. 


- MASS STORAGE ERROR. 


- MISSING *SHELL* LOAD OPTION. 
- SECONDARY USER COMMANDS DISABLED. 


~ SYSTEM ERROR. 


- USER ACCESS NOT VALID. 


ERROR EXIT AT address. 


CALL ERROR. 


DATA/PERMIT ERRORS. 
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SIGNIFICANCE 


An incorrect pack name has’ been specified. 


A job was incorrect cM: funetion code, 
subfunction code was specified, or extended 
reprieve is set (for EREXIT). 


There was an error in your job page size 
information. 


The system could not find the 
specified Library. 


A non-recoverable mass storage error is 
detected by CPM when attempting to access a 
mass storage device, or a recoverable mass 
storage error has occured during a disk 
access attempt, causing the job to roll out 
and wait for the device to be repaired. 


One of the following: 

- A nonrecoverable:error occurred when 
your job attempted to access a mass 
storage device. 

- Your job was aborted after being 
rolled out due to a recoverable mass 
storage device error. 


You attempted to set a shell’ control 
without specifying a load option. 


You entered a secondary USER command on a 
system that has had secondary USER commands 
disabled. 


‘For function 42 (Special Charge) or 106 


(Set Job Characteristics), CPM was unable 
to read the input file. ' 


1. You tried to perform a CPM operation for 
which you are not authorized. 

2. A CPU program issued a DSDOUT or a 
DSDINP macro request when it did not 
have access to the L display CMR buffers. 


The errors Listed after this message 
occurred at address, causing job 
termination. 


If CVL was called by a user via GETMC, 

CVL encountered one of the following 

errors while processing the GETMC 

macros mo 

- Recall bit was not set. 

- Illegal function number was specified. 

- Insufficient or improper combination of 
parameters was specified. 


If CVL was called by a CE via CEVAL, 

CVL encountered one of the following 

errors while processing the CEVAL macro: 

- Recall bit was not set. 

- Illegal function number was specified. 

- Insufficient or improper combination of 
Parameters was specified. 

- The CE supplied mnemonic does not 
match the preassigned tape mnemonic when 
CVL was called by preassignment. 

- A tape was not preassigned when CVL was 
called by ‘preassignment. 

- The CE attempted to load tape 
controlware when CVL was called by 
preassignment. 

- A labeled tape was preassigned when CVL 
was called by preassignment. 


When ‘the specified file was loaded from 
tape, errors were encountered in both data 
and permit information. 


ACTION 


Ensure that a valid pack 
name is used. 


Specify auto recalkt on 
monitor request call to 
CPM. 


Retry with correct 
values. 


Ensure that the Library 
name is correct on the 


_command or macro. 


Repair the device and 
retry. 


Inform site analyst. 


Specify a load option in 
the shell command or 
macro and try again. 


None. 


Write a PSR and include 
support materials to 
allow CDC to duplicate 


“the problem. 


Ensure that the L 
display utility was 
initiated at the system 
console with the 
appropriate commands. 


Refer to the 
descriptions of the 
error messages issued 
with this message. 


Correct error and rerun 
program. 


Enter CHANGE command or 
macro with CE parameter 
to allow access to the 
file. Make the file 
local and check if data 
is accurate. Enter a 
CATLIST command to see 
if the permits are 
accurate. 


ROUTINE 


CPM 


cPM 


CPM 


CPM 


CPM 


CPM 


CPM 


“ CPM 


CPM 


CPM 


4A 


CVE 


PFM 


MESSAGE 


DATA TRANSFER ERROR. 


DBest ,DNdn,message. 


DEFAULT FAMILY USED. 


DEMAND EXCEEDED. 


DEMAND FILE ERROR. 


DEVICE ERROR ON FILE filename AT address. 
DEVICE INACCESSIBLE - DETACH FAILED. 
DEVICE INACCESSIBLE - LOGIN FAILED. 


DEVICE UNAVAILABLE. 


DIest,DNdn,message. 


DIRECT ACCESS DEVICE ERROR. 


DIRECT ACCESS FILE ERROR. 


OJest,DNdn,message. 
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SIGNIFICANCE 


An error occurred in a read operation 
during a file transfer. 


A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 


occurred. The equipment type DB is 885-42 
disk (full track). 

est EST ordinal of device. 

dn Device number. 


message PFM error message. 


You entered a FAMILY command with no 
parameter. The default family was used. 


You attempted to assign more units than 
were scheduled on the RESOURC command. 


Resource execution error was encountered. 
This error occurred because the demand file 
{RSXDid) entry does not match the job 
identification. 


An irrecoverable error occurred on the mass 
storage device containing the file filename. 


Your job could not be detached due to a 
mass storage device error. 


Login failed because of mass storage device 
error. 


One of the following: 

- A packname was specified for a pack that 
is not currently mounted. 

- For a DIS job, no SUI or USER command 
has been entered. 

- No permanent file device could be found 
for your user name. 

- On a secure system, no permanent file 
device with the proper access Level 
could be found for your user name. 


A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 


occurred. The equipment type DI is 844-21 
disk (half track). 

est EST ordinal of device. 

dn Device number. 


message PFM error message. 


One of the following occurred: 

- An incorrect device type was specified. 

- The device on which the local file 
resides may not contain direct access 
files. 


The system sector for the file contains 
incorrect data or cannot be read. 


A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 


occurred. The equipment type DJ is 844-41/44 
disk. : 

est EST ordinal of device. 

dn Device number. 


“message PFM error message. 


ACTION 


Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITIALIZE, 
and full PFLOAD on the 
device. 


Refer to the 
significance and action 
of the message as given 
in this tist of error 
messages. 


None. 


Increase appropriate 
parameter value on 
RESOURC command. 


Rerun the job. If the 
problem recurs, inform 

a site analyst, write 

a PSR and include 
support material so that 
CDC can duplicate the 
problem. 


Inform customer engineer. 


Inform site analyst. 


Inform site analyst. 


If a packname was 
specified, try again 
with the WB or NA 
parameter to request 
that the pack be 
mounted. For other 
errors, inform site 
operator. 


Refer to the 
significance and action 
of the message as given 
in this List of error 
messages. 


Specify correct device 
type, or return the 
local file and retry. 


Inform site anlyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITIALIZE, 
and full PFLOAD on the 
device. 


Refer to the 
significance and action 
of the message as given 
in this List of error. 
messages. 


ROUTINE 


PFM 


PFM 


CONTROL 


RESEX 


RESEX 


1MS 


IAFEX 


ITAFEX 


PFM 


PFM 


PFM 


PFM 


PEM 
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MESSAGE 


DKest,DONdn,message. 


DLest ,DNdn message. 


DMest ,DNdn,message. 


DGest ,DNdn,message. 


DSP - CANNOT ROUTE JOB INPUT FILE. 
DSP - COMPLETE BIT ALREADY SET. 

DSP - DEFERRED ROUTING NOT ALLOWED. 
DSP - DEVICE FULL. 

DSP - DEVICE UNAVAILABLE. 

DSP ~ FILE NAME ERROR. 

DSP - FILE NOT ON MASS STORAGE. 

DSP — FILE ON REMOVABLE DEVICE. 

DSP ~ FOMSM CODE NOT ALPHANUMERIC. 
DSP ~ I/0 SEQUENCE ERROR.- 

DSP - IMMEDIATE ROUTING - NO FILE. 
DSP = INCORRECT DISPOSITION CODE. 
DSP -. INCORRECT EXTERNAL CHARACTERISTICS. 
DSP ~- INCORRECT FILE. TYPE. 
60659690 F 


SIGNIFICANCE 


A form of PFM error message (issued to the 
system dayfite, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 


occurred. The equipment type DK is 844-21 
disk (full track). 

est EST ordinal of dévice. 

dn Device number. 


message PFM error message. 


A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 


occurred. The equipment type DL is 844-41/44 
disk (full track). : 
est EST ordinal of device. 
dn Device number. 


message PFM error message. 


A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which-the error 


occurred. The equipment type DM is 885-11/12 
disk (half track). 

est EST ordinal of device. 

dn Device number. 


message PFM error. message. 


A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 


occurred. The equipment type DQ is 885-11/12 
disk (full track). 

est EST ordinal of device. 

_dn Device number. 


message PFM error message. 


An attempt was made to route the job input 
file. 


The complete bit was not cleared before DSP 
was called. . 


. A file cannot be deferred routed if data 


declaration, or implicit/explicit remote 
text is specified. 


There is no space on the device for current 
use. 


OSP attempted to create a file on a device 
that was turned off or is currently 
unavailable for access. 


An attempt was made to create a file with 
an incorrect file name. 


An attempt was made to route a file not on 
mass storage. 


A file on a removable device cannot be 


routed. 


The forms code specification (FC=fc 
parameter) must consist of two . 
alphanumeric characters. 


A request was made on a busy: file. 


The specified file for the immediate 
routing could not be found. 


Specified disposition code is not 
recognized. 


You specified an undefined external 
characteristic code. 


The file being processed is not’ a queued 
file or a local: file. 


ACTION 


Refer to the 
significance and action 
of the message as given 
in this list of error 
messages. 


Refer to the 
significance and action 
of the message as given 
in this List of error 
messages. : 


Refer to the 
significance and action 
of the message as given 


‘in this List of error 


messages. 


Refer to the _ 
significance and action 
of the message as given 
in this list of error 
messages. 


Copy job input file to a 
local file and route it. 


Clear complete bit 
before calling DSP. 


Correct and retry. 


Retry route at a Later 
time. 


Specify different device 


or contact site operator. 


Specify valid file name. 


Copy file to mass 
storage before routing. 


Copy file to 
nonremovable device 
before routing. 


Specify alphanumeric 
forms code. 


Wait until file is not 
busy. 


Ensure that file to be 
routed is available to 
job for processing. 


Verify disposition code. 
Verify external 
characteristic code. 
Ensure the file being 


processed is of the 
correct type. 


ROUTINE 


PFM 


PFM 


PFM 


PFM 


DSP 


osP 


DSP 


DSP 


OSP 


oSP 


oSP 


DSP 


psp 


DSP 


OSP. 


psP 


oSsP 


DSP 
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DSP 
DSP 
DSP 
psp 
DSP 


DSP 


oSP 


DSP 


osP 


DSP 


DSP 


DSP 


DSP 


DSP 


DSP 


MESSAGE 


INCORRECT INTERNAL CHARACTERISTICS. 
INCORRECT JOB ABORT CODE. 
INCORRECT ORIGIN TYPE. 


INCORRECT REQUEST. 


INCORRECT SERVICE CLASS 


INCORRECT SPACING CODE. 


INCORRECT TID. 


INCORRECT USER COMMAND. 


INVALID FILE MODE. 


MASS STORAGE ERROR. 


QUEUED FILE READ ERROR. 


er 2 


ROUTE TO INPUT NOT IMMEDIATE. 


THIS ROUTING NOT ALLOWED. 


TOO MANY DEFERRED BATCH JOBS. 


UNDEFINED SERVICE CLASS. 


USER ACCESS NOT VALID. 


DUPLICATE FILE NAME. 


DUPLICATED LINES. 


DVest ,DNdn,message. 


SIGNIFICANCE 


You specified an undefined internal 
characteristics code. 


Value of abort code field of DSP parameter 
word four is incorrect. 


The system cannot queue the file for input 
with the specified origin type. 


One of the following: 

- Parameter block is not within field 
Length. 

= Request was not made with auto recall. 


The two-character service class is not 
valid for the user or the origin type of 
the file. 


Value specified for spacing code was 
greater than 77 octal. 


One of the following: 

- Username and familyname parameters were 
not in CM field length. 

- Terminal identifier (TID) is greater 
than or equal to IDLM for batch jobs. 

- The familyname or username is not valid. 


For an operation on an input file, either a 
USER command was not inckuded, or the user 
name or password on USER command jis not 
valid. 


The file being processed is attached in 
execute~only mode. 


A mass storage error was encountered on the 
file. 


DSP encountered an error while trying to 
read the system sector for a previously 
deferred routed file. 


You attempted to queue a file for input 
using a deferred ROUTE. 


You attempted to change the queue 
disposition of a deferred routed file. 


You attempted to submit more deferred batch 
jobs than altowed by your validation Limit. 


The two~character service class is not 
defined. 


Caller is not validated to specify one of 
the following: 

DLID 

SLID 

Data declaration 


The file specified already exists in the 
system. 


Duplicate Lines, which would have been 
printed during a dump operation, were 
suppressed. 


A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass 
storage equipment on which the error 
occurred. The equipment type is 819 disk 
(single density). 

est EST ordinal of device. 

dn Device number. ~ 

message PFM error message. 


ACTION 


Verify internal 
characteristics code. 


Verify abort code. 


Specify valid origin 
type. 


Change parameter block 
addresses or specify 
auto recall. 


Correct and retry. 


Verify spacing code. 


Verify that TID 
parameters are valid. 


Verify that a USER 
command is present and 
that the user name and 
password are correct. 


Return the file and 
reattach it in other 
than execute-only mode. 


Write a PSR and include 
support materials to 
allow COC to duplicate 
the problem. 


Attempt to recreate the 
output file... 


Change to immediate 
route. 


Rescind prior routing by 
using the SC disposition 
code with the ROUTE 
command or macro. Route 
the file again with the 
desired final 
disposition code. 


Wait for jobs to 
complete or request a 
larger validation Limit 
from site personnel. 


Correct and retry. 
Write a-PSR and include 
support materials to 


allow CDC to duplicate 
the problem. 


Use different name in 
request. 


None. 


“Refer to the 


significance and action 
of the message as given 
in this List of error 
messages. 


ROUTINE 


OSP 
DSP 
“ OSP 


DSP 


DSP 


osP 


DSP 


osP 


DSP 


DSP 


DSP 


DSP 


DSP 


DSP 


DSP 


DSP 


LFM 


CPMEM 


PEM 
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MESSAGE 


DWest ,DNdn message. 


EC NOT VALIDATED. 


ECS LOAD ERROR. 


filename EMPTY. 


-ELM = ARGUMENT ERROR. 


ELM ~ EXTENDED MEMORY NOT ASSIGNED. 


ELM - DAYFILE MESSAGE LIMIT. 


END OF TAPE, filename AT address. 


ENTRY POINT NOT FOUND. 


EOI CHANGED BY RECOVERY. - 


E@est xx ERROR RETRY UNDERWAY 


EQest xx ERROR RETRY UNDERWAY 


EQUIPMENT NOT AVAILABLE. 


60459690 J 


SIGNIFICANCE 


A form of PFM error message (issued to the 
system dayfile, error log, and sometimes 
the user dayfile) identifying the mass - 
storage equipment on which the error . : 
occurred. The equipment type DW is 819 dis 
{double density). 

est EST ordinal of device. 

dn Device number. 

message PFM error message. 


The number of extended memory blocks 
specified on the Job command either exceeds 
that for which you are authorized or 
exceeds the machine size available to user 
jobs. 


* An error occurred during ECS Load. 


The file specified on a SAVE command 
contains no data. 


ELM was called with an incorrect 
device code or error block address. 


A call was made to ELM with no extended 
memory assigned to the job. 


The caller's dayfile Limit was reached 
during ELM processing. 


The end-of-tape was encountered. 


The specified entry point could not be 
found. 


The file was truncated during deadstart 
recovery. 


An error has occurred while attempting to 
read data from, or write data to, a mass 
storage device; a recovery attempt is in 
progress, . 
est EST ordinal of the mass storage 
device in use when the error 
occurred. 
xx Error type Cone of the following): 
CH Channel parity error 
CS Controller stop error 
RA Controller memory error 
FT Function timeout error 
PE Parity error 
AD Address error 
ST Device status error 
RS Device reserved error 
CR Controller reserved error 
NR Device not ready error 


An error has occurred.while attempting to 
read data from, or write data to, a mass 
storage device; a recovery attempt is in 
progress. 
est EST ordinal of the mass storage 
device in-use when the error 
occurred. 
xx Error type (one of the following): 
CH Channel parity error 
CS Controller stop error 
RA Controller memory error 
FT Function timeout error 
PE Parity error 
AD Address error 
ST Device status error 
RS Device reserved error 
CR Controller reserved error 
NR Device not ready error 


The requested equipment is either in.use . 
or does net exist, or no requested 
equipment with the proper access Level 
can be found. 


ACTION 


Refer to. the 
significance and action 
of the message as given 
in this list of error 
messages. ; 


Check your validation 
with the LIMITS command. 


Inform site analyst. 


‘Verify that file 


contains data and retry. 


Check the program that 
made the call. 


Check the job for extended 
memory assignment. 


None. 

Ensure that correct file 
manipulation operation 
is specified. 


Verify that entry point 
is valid. 


Use CHANGE command or 


- macro with CE parameter 


to allow access to the 
file. Make the file 
local and List it to 
determine how much of 
the file was lost. 


Resubmit the job. If 
the error recurs, inform 
site analyst or customer 
engineer. 


Resubmit the job. If the 
error recurs, inform site 
analyst or customer 
engineer. 


Ensure accuracy of macro 
or command or retry at a 
later time. 


ROUTINE 


PFM 


CPM 


1AJ 


PEM 


ELM 


ELM 


ELM 


IMT 


1AJ 


PFM 


6DI 
6oP 
6DE 
60x 
1MC 


. ELM 


601 
6DP 
6DE 
6DX 
MC 
€LM 


LFM 
RESEX 


MESSAGE 


ERASE LIMIT, filename AT address. 


ERROR CODE ec, filename AT address. 


ERROR - FILES(S) NOT PROCESSED. 


ERROR FLAG TERMINATION, filename AT address. 


ERROR FLAG TERMINATION, FILE filename AT 
address 


ERROR IN FILE DATA. 


ERROR IN PERMIT DATA. 


ERROR IN ROUTE FUNCTION, LFN=filename. 
ERROR ON FILE - PROFILa. 


ERROR PROCESSING LIMIT. 


EXCHANGE PACKAGE/MEMORY DUMP ON FILE 
ZZZDUMP. 


EXTENDED MEMORY BLOCK OUT OF RANGE. 


EXTENDED MEMORY FLAG REGISTER PARITY. 


EXTENDED MEMORY OUT OF RANGE. 


EXTENDED MEMORY PARITY ERROR. 


FAMILY NOT FOUND. 

FET ADDRESS OUT OF RANGE AT address. 

FET PARAMETER ERROR ON filename AT address. 
FET TOO SHORT. 


FIELD BEGINNING AT nn NO COMPARE, 


FILE BOI/EOI/UI MISMATCH. 
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SIGNIFICANCE 


The system made 20 erasures (10 feet of 
tape) without being able to successfully 
write the tape. 


1MT error code ec has occurred but no 
specific message is issued. This would 
normally not occur unless the job was 
dropped by the operator. 


One or more files were not checkpointed 
because CHKPT detected an error while 
getting a list of the files at the control 
point. This could occur if there are many 
local files. 


The job was aborted with a tape operation 

in progress. The operation/request is not 
complete. For example, the operator could 
kill the job while tape error recovery is 

in progress. 


The job was aborted with an input/output 
request in progress. The operation/request 
is not complete. 


When the specified file was loaded from 
tape, an error was encountered in the data. 


When the specified file was loaded from 
tape, an error was encountered in the 
permit entries. 


Informative message issued to the system 
dayfile indicating that an error occurred 
while routing filename. 


‘Either the profile file cannot be found or 


there is a bad profile file levet-3 block 
random address. 


Following an error, a job has tried to 
restart itself more than 512 times. 


The exchange package and memory dump is 
written on local file ZZZOUMP because the 
job is of interactive origin and file 
OUTPUT is assigned to a terminal. 


Data transfer between CM and extended 
memory specified an extended memory address 
outside the job field length. 


Parity error detected on extended memory 
flag register operation. 


Job referenced extended memory address 
outside job field Length. 


ECS transfer on a model 176 failed. 


No family exists with the name you 
specified. 


FET extends past job's field Length or FET 
address .LE. 1. 


A parameter in the FET is incorrect or the 
FET is not long enough for the parameter. 


FET is not long enough for processing by 
requested function. 


Verification of label field at character 
position nn does not compare with that 
specified by the user on an OPEN statement. 


Data in the system sector for file filename 
does not match information from the EOI 
sector and/or catalog information. This 
indicates that the file has been destroyed. 


ACTION 


Clean tape or use 
different tape. 


Inform site anatyst. 


Contact Central Software 
Support. 


None. 


None. 


Enter CHANGE command or 
macro with CE parameter 
to allow access to the 
file. Make the file 
local and ensure the 
accuracy of the data. 


Enter CHANGE command or 
macro with CE parameter 
to allow access to the 
file. Do a CATLIST to 
see if the permits are 
accurate. 


Examine the job’s 
dayfile for a more 
specific error message. 


Inform site analyst. 


None. 


To examine the exchange 
package and dump, List 
file ZZZDUMP. 


Analyze the job output 
and dumps to determine 
the cause of the error. 


Inform customer engineer. 


Analyze the job output 


and dumps to determine 
the cause of the error. 


Inform customer engineer. 


Retry with an existing 
family name. 


Verify that FET address 
is valid. 


Verify that FET is valid. 


Increase FET size. 


None. 


Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITALIZE, 
and full PFLOAD on the 
device. 


ROUTINE 


1T 


mT 


CHKPT 


IMT 


1MS 


PFM 


PEM 


DSP 


CPM 


1AJ 


CPMEM 


1AJ 


1AJ 


TAS 


CONTROL 


1MS 


iMS 


LFM 


FM 
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MESSAGE 


FILE EMPTY, 
FILE ERROR filename. 


FILE/JOB NOT FOUND. 


FILE LENGTH ERROR. 


FILE NAME ERROR, 


FILE NOT DISK RESIDENT. 


FILE NOT ON MASS STORAGE, 


FILE TOO LONG. 


FILE TOO LONG, FILE filename AT address. 


FL. REQUEST BEYOND MFL (ECS). 
FL TOO SHORT FOR PROGRAM. 

FLE TOO SHORT FOR LOAD. 

FNT FULL. 

FORMAT REQUIRES UNLABELED TAPE. 


FUNCTION REJECT, filename AT address. 


FWA .GE. LWA+1. 


FWA/LWA .GE. FL. 


GETFNT TABLE TOO LARGE. 


HARDWARE RERUN THRESHOLD EXCEEDED 


60459690 J 


SIGNIFICANCE 


The file specified was empty. 


An incorrect address was detected on file 
filename. 


The specified file or job was not found. in 
the system. 


The Length of a file does not equal the 
length specified in the catalog. This 
indicates that the file has been 
destroyed. 


File name contains incorrect .characters or 
contains more than seven characters. 


Access to a file which does not reside on 
disk is not pereitred with the requesting 
function. 


The specified file does not reside on mass 
storage. 


The local file specified for a SAVE, 
REPLACE, or APPEND command exceeds the 
Length allowed or the direct access file 
specified for an ATTACH operation in WRITE, 
MODIFY, UPDATE, or APPEND mode exceeds the 
direct access file length Limit for which 
you are authorized. 


rs 


The length of the direct access permanent 


file currently being written exceeds the 
direct access file Length Limit for which 
you are authorized. 


Extended memory field Length requirements 
for the job step exceed the extended memory 
field Length allowed. 


The job's field Length is too short for the 
program. : 


You attempted to load extended memory data 
beyond the job's extended memory field 
length. 


FNT space is currently not available for a 
request that has both the ep and up 
processing options set. 


The format specified (F) is valid only for 
unlabeled tapes. 


Function was rejected (possible hardware 
problem). 


The first word address parameter was 
greater than the Last word address 
parameter on DMP, DMD, DMPECS, DMDECS, LOC, 
or PBC command or DMP, DMD, DED, or DEP 


“system requests. 


Either first word address parameter of LOC 
or-the last word address of LOC or PBC was 
greater than or equal to your field length. 


The table generated by the GETFNT macro is 
too large to fit in the job's field Length. 


A job will be rerun a maximum of n~1 times 
due to a hardware error. The default for n 
is 2 (defined by HRTL in common deck 
COMSMSC). 


ACTION 


Verify that the file 
contains data and retry. 


Correct error and retry. 


Use the ENQUIRE command 
to ensure job is still 
in the system. 


Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFOUMP, total INITIALIZE, 
and full PFLOAD on the 
device. 


Ensure that a valid file 
name is specified. 


Write a PSR. 


Copy file to mass 
storage and retry. 


Reduce length of file or 
save as a direct access 
file. 


Reduce the Length of the 
file or ask site 
personnel for a larger 
direct access file 
length Limit. 


Increase job step 
extended memory field 
length. 

Rerun the job with 
larger field length 
specification. 


None. 


Return some files .and 
retry operation. 


The tape must be 
assigned as an unlabeled 
tape. 


Inform site analyst. 


Correct error and retry. 


‘Reduce FWA and/or LWA 


and retry. 


Specify larger GETFNT 
table size. 


Analyze job dumps, 
maintenance registers 
and the error log to 
determine cause. 


ROUTINE 


LFM 
SFM 


RESTART 


CONTROL 


PFM 


1AJ 


PF 


IMS 


1MA 
1AJ 
1AJ 
1Ad 
PEM 


RESEX 


1MT 


CPMEM 


CPMEM 


LFM 


. TAS 
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MESSAGE 
HTIME NOT AVAILABLE. 


1/0 ON EXECUTE-ONLY FILE filename AT 
address. 


1/0 SEQUENCE ERROR. 


1/0 SEQUENCE ERROR ON FILE filename AT 
address. 


IMPROPER ACCESSIBILITY. 


INCORRECT ACCESS LEVEL FOR EQUIPMENT. 


INCORRECT APPLICATION ACCOUNTING REQUEST. 


INCORRECT COMMON MEMORY MANAGER REQUEST. 


INCORRECT DEVICE REQUEST. 


INCORRECT END OF JOB OPTION SPECIFIED. 


INCORRECT EQUIPMENT. 


INCORRECT EQUIPMENT ON FILE filename AT 
address. 
INCORRECT ERROR EXIT ADDRESS. 


INCORRECT EXTERNAL CALL. 


INCORRECT FILE MODE. 


INCORRECT FILE NAME filename AT address. 


INCORRECT FILE STATUS. 


INCORRECT FILE TYPE. 


pfn INCORRECT FILE TYPE. 


SIGNIFICANCE 


The HTIME. command or. macro is valid only on 
a model 176. 


Your job issued a CIO function not allowed 
on an execute-only file. 


Action was requested on a busy local file. 


You attempted to perform a function on a 
local file before another function on the 
same file was complete. 


You did not specify the correct file 
accessibility on the LABEL command or 
macro, or volume accessibility was set and 
you attempted to assign the tape as 
unlabeled from a nonsystem origin job. 


You have specified a Level outside of the 
equipment access Level Limits. 


The application program that issued this 
message attempted to initiate application 
accounting incorrectly. 


A memory request was issued with reserved 
bits in the parameter block set. 


The device type (R parameter) specified on 

a request for an auxiliary device cannot be 
recognized or does not exist in the 

system. If the auxiliary device specified 

by the PN parameter is not the same type as 
the system or job default, the R parameter 

must be included. 


The option specified is not valid for a 
noninteractive job. i 


Equipment specified does not exist or is 
not allowed (for example, an interactive 
teminal is requested from other than 
interactive origin, or a tape is being 
requested with the REQUEST macro). 


A system error. 


Error exit address is beyond the job's 
current field Length. 


RESEX did not recognize an external call. 


You tried to unlock a file that was 
attached in execute-only mode. 


The file name does not conform to the 
rules. The file name must have a maximum 
of seven alphanumeric characters, 
left-justified, with binary zero fill. 


Specified file status is incorrect. 


The specified file is of a type not allowed 

in the requested operation. Possible 

causes include attempts to 

- Change a nonlocal file to file type 
library. 

- Designate a direct access file as the 
primary file. 

- Route the primary file. 

- Change access level of nonlocal file. 


The operation requested cannot be performed 
on the specified file because it is of the 
wrong file type. This message is issued 

when you 1) attempt to define a direct access 
file with the same local file name as a 

file currently assigned to the job that is 

of a file type other than local, or 2) the 
local file being saved is a direct access 
file attached in read/allow modify or 
read/allow append mode. 


ACTION 


None. 


Attach file in proper 
mode to allow the 
desired operation. 


Write a PSR. 


Modify program to wait 
until each function is 
complete before 
attempting another. 


Ensure accuracy of 
request. 


Use access level within 
required equipment's 
access level limits, or 
use equipment with 
access level required. 


Inform data base 
administrator. 


Do not set reserved bits. 


Examine auxiliary device 
request and ensure its 
accuracy. : 


Retry with a different 
option. 


Ensure that file resides 


on a legal equipment 
type. 


Inform site analyst. 
None. 


Inform site analyst. 


None. 


Use valid file name. 


Check value. 


Verify that file type is 
appropriate. 


1) Define the file use- 
ing a unique name, or 

2) Return the file and 
reattach it in a differ- 
ent mode. 


ROUTINE 


TAS 


IMS 


LFM 
PFM 
1Ad 


1MS 


RESEX 


RESEX 


cPM 


TMA 


PFM 


CPM 


LM 


RESEX 


IMS 


1AJ 


RESEX 


LFM 


1MS 


LFM 


LFM 


PFM 


60459690 J 


MESSAGE 


INCORRECT 1/0 REQUEST ON FILE filename AT 
address. 


INCORRECT ID CODE. 


INCORRECT INSTRUCTION. 
INCORRECT LABEL TYPE, filename AT address. 


INCORRECT LOAD ADDRESS. 


INCORRECT MODIFICATION OF filename AT address. 


INCORRECT RANDOM ADDRESS. 


INCORRECT USER ACCESS. 

INDEX ADDRESS OUT OF RANGE FOR filename AT 
address. 

INDEX TOO LARGE ON OPEN, FILE filename AT 

. address. 

INPUT FILE IN NO RERUN STATUS. 


INPUT FILE IN RERUN STATUS. 


INPUT LOST, REENTER LAST LINE 


INSUFFICIENT RESOURCES ON SYSTEM. 


INTERLOCK NOT AVAILABLE. 


pfn INTERLOCKED. 


INVALID FILE ACCESS LEVEL. 


pfn IS DIRECT ACCESS. 
filename IS EXECUTE ONLY. 
pfn IS INDIRECT ACCESS. 


ITF, CONNECTING TO HOST pid. - 


JOB CANNOT ACCESS FILE. 


60459690 F 


SIGNIFICANCE 


The system could not recognize the 
specified function code, or the code was 
not valid for the type of device to which 
the file was assigned. You attempted to 
write on a local file that resides on a 
device whose highest access level is below 
the current access level of your job. The 
system provides a dump of the FET on file 
OUTPUT. - 


An identification code not in the range 
0-678 or 778 is present on the LDI command. 


The CPU attempted to execute an incorrect 
or unavailable instruction. 


Incorrect label type. The only valid Label 
types are ANSI Labeled and nonstandard 
labeled. 


The load address is less than 2. 


Either you have attempted to shorten a 
modify-only file or the file cannot be 
modified at all. 


The current random address specified is 
zero. 


You are not authorized to access a 
restricted subsystem without proper 
validation. 


The random sector address for a random 
input/output request was equal to or 
greater than the job's field length. 


For an OPEN function, the random index 
length exceeded the index buffer size. 


Informative message. 


Informative message. a 


Your lst Line of input was lost due to’ an 
IAF internal error. 


Resource demand exceeds the number of units 
physically available on the system. 


A software interlock is currently not 
available to the requesting function with 
both ep and up processing options specified. 


The file is currently not available for 
WRITE, MODIFY, UPDATE, or APPEND modes of 
access because a system utility has 
attached the file in utility mode. 


The access level specified in the FET for 
an LFM request is not valid: for that user, 
or for the equipment on which the file 
resided. 


An indirect access file operation was 


attempted on a direct access file. 


The specified local file cannot be accessed 
by SAVE, REPLACE, APPEND or DEFINE since it 
is an execute-only file. 


A direct access file operation was 
attempted on an indirect access file. 
Indicates state of connection.to host pid.- 
The permanent file being processed has 


either an access level or access categories 
that are not vatid for your job. 


ACTION 


Verify C10 function code 
being used. Lower the 
access level of your 
job, if possible, or 
raise the access level 
of the file. 


Reissue the request with 
the correct 
identification code. 


Analyze job. output and 
dumps to determine the 
cause of the error. 


Use correct Label type. 


Specify larger load 
address and retry. 


Determine whether file 
can be modified. 
Verify current random 
address. 

Determine proper 


validation requirements. 


Correct random sector 
address. . 


Set EP bit in FET+1 to 
get error status without 
abort or increase index 
buffer size. 


None. 

None. 

Reenter the Last line. 
If the error recurs, 
inform site analyst or 
customer engineer. 
Reduce resource demand. 


Retry function at a 
later time. 


Retry operation Later. 


Correct the access level 
and retry. 


Use the appropriate 
direct access file 
request. 


None. 


Use the appropriate 
indirect access file 
request. 


None. 


None. Your: job can-not 
access the file. 


ROUTINE 


4ms 


LDI 


1AJ 


AMT 


TAS 


IMs 


LFM 


EXINIT 


4MS 


1MS 


QFM 
QFMm 


TAFEX 


RESEX 


PFM 


PFM 


LFM 


PEM 


PFM 


PFM 


ITF 


PFM 
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MESSAGE 


JOB CARD ERROR (jobemmnd) 


JOB IN NORERUN STATE ON RECOVERY. 


JOB NOT RERUN. 


JOB REPRIEVED. 


JOB RERUN. 


JOB STEP ABORT. 


JOB STEP EXCEEDS ACCOUNT BLOCK. 


JOB STEP LIMIT. 


LABEL CONTENT ERROR, filename AT address. 


LABEL MISSING, filename AT address. 


LABEL NOT EXPIRED. 


LABEL PARAMETER ERROR ON OPEN, filename 
AT address. 


LDR ERROR. 


LFM DETECTED ERROR. 


LFM ERROR. 


LFM INCORRECT REQUEST. 


LINE WAS DISCONNECTED WHILE LOANED. 


' LOADER MISSING. 


LOCAL FILE LIMIT. ms 


M.T. NOT AVAILABLE ON FILE filename AT 
address. 


BH14 


SIGNIFICANCE 


The Job command of a routed job contains an - 


error. jobcmmnd is the first 20 characters 
of the Job command in error. 


Identifies a job recovered on level 0 or 
level 3 deadstart that was aborted because 
it was in a no-rerun mode (due to NORERUN 
command or macro). 


The system was unable to successfully rerun 
a job because of a mass storage read error 
or because the QFT is full. 


The job has been successfully. reprieved. 


The job has been terminated and requeued 
for input. 


The job step was aborted due to mass 
storage device error. 


You tried to set your job step Limit to a 
value greater than your account block Limit 
or tried to set your account block Limit to 
a value less than your job step Limit. 


The monitor detected the expiration of the 
job step SRU Limit. . ag 


A block read was the correct size for a 
label but one or more required fields (such 
as the label name) were incorrect. 


During a read operation, a required Label 
was missing. 


You attempted to write on a tape with an- 
unexpired Label. 


Label fields did not match on open 
request. An additional message, 

FIELD BEGINNING AT addr NO COMPARE. 
specifying the decimal character position 
in HDR1 of the first field that did not 
compare correctly, is also issued. 


Issued before one of the following errors: 
~ OVERLAY NOT FOUND IN LIBRARY. 
~ ARGUMENT ERROR. 


The Resource Executive (RESEX) detected an 
error. 


LFM detected an error in the request. See 
other error messages in dayfile for more 
information. 


One of the following: 


- The function detected was not recognized - 


as a valid LFM function. 
- An LFM function was issued without the 
auto recall bit set. 


The Line connection-to your secondary 
application was broken.- 
1AJ could not find BEGIN or LDR=. 


The job tried to create too many local 
files. 


The magnetic tape executive is not 
executing. 


ACTION 


Correct the Job command 
and retry. 


Refer to the NORERUN 
command or macro 
description. 


Resubmit the job to the 
system. 


None. 


None. 


Retry the job step. If 
the problem recurs, 
inform site analyst. 


Check values on SETJSL 
and SETASL commands. 


Reset job step Limit 

with SETJSL command or 
macro and retry. If job 
step SRU Limit is set at 
maximum, request 
increased SRU validation. 


Use LISTLB command to 
obtain label data and 
retry. 


Ensure that tape has 
label. 


If current contents of 
tape can be sacrificed, 
have operator blank 
label tape. Otherwise, 
wait until Label has 
expired. 


Use LISTLB command to 
obtain label data. 


Correct error and retry. 


Inform site analyst. 


Ensure that a valid LFM 
request is being made. 


Verify that a valid-LFM 
request is being used. 


Enter another APPSW 
command to reestablish 
the connection. 

Inform software support. 
Reduce: local file usage. 


Inform’ site operator. 
Bring up MAGNET. 


ROUTINE 


DSP 


1AL 


1AJ 


TAN 


TAJ 


TAL 


CPM . 


1AJ 


AMT 


AMT. 


AMT 


1MT 


LDR 


LFM 


LFM 


LFM 


TLX 


TAJ 


qAJ 


IMS 
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MESSAGE 


MAGNETIC TAPE SUBSYSTEM NOT ACTIVE. 


MASS STORAGE ERROR. 


MESSAGE LIMIT. 


MFL LESS THAN EXTENDED MEMORY MINIMUM CM FL. 


MFLINK ~ WRONG REMOTE APPLICATION LEVEL. 
MFLINK - TRANSFER IMPOSSIBLE TO ST Lid. 


MISSING DEMAND FILE ENTRY. 


jsn MISSING RESOURCE. 


MISSING VSN OR EQUIPMENT ASSIGNMENT. 


MLF REQUEST TOO SMALL, MINIMUM USED. 


MONITOR CALL ERROR, xxxx nnonnnnnn. 


MT,Ccc,Eec,Hhhhhhhhh,B.C. RESTART. 


NT,Ccc,Eec,Hhhhhhhhh,BAD ERASE. 


60459690 F 


SIGNIFICANCE 

One of the following occurred during a 
Magnetic tape request: ; 

~ There was no UDT address in the FST. 

- The UDT address in the FST was incorrect. 
- The MAG subsystem was not present. 


An error was encountered in reading a 
portion of the permanent file catalog or 
permit information (error log and dayfile 
message). This indicates a hardware 
problem with a disk pack or disk drive. 


The number of messages issued by the job 
has exceeded the Limit for which you are 
authorized. Message functions issued by 
compilers or applications that run in the 
job*s field length are also counted as job 
dayfile messages and thus are subject to 
your dayfile message Limit. : 


To use extended memory you’ must have a 
required minimum amount of central memory 


“field length. This message indicates that 


you do not have the required central memory 
field length. , 


You ‘entered an MFLINK command with ST=Lid; 
the transfer failed because MFLINK's. 
protocol version or level is: inompatible 
with. the Permanent File Transfer Facitity 
(PTF) Saver software at the remote host. 


Dayfile message indicating a RESEX internal 
problem, The overcommitment algorithm was 
initiated without a demand file entry 
having been defined previously. 


Dayfile message indicating that a RESEX 
internal problem occurred. RESEX expected 
but did not find a resource unit assigned 
to the job with job sequence number jsn. 
This could occur if the MAG subsystem was 
stopped while tapes were assigned. 


: 


Dayfile message indicating internal 
malfunction in RESEX (expected VSN or 
equipment assignment was not. found). 


The SETMFL macro (CPM function 52) 
attempted to specify a maximum FL value 
lower than the minimum required for a 
subsequent MFL command. 


One of the following occurred during the 

processing of an monitor request: 

- The monitor request call was not 
recognized by the system. 

- Bad parameters were supplied in the 
request. 

- Incorrect user access was encountered. 

- An incorrect request was included in the 
request. 


Magnetic tape controller controlware 
restarted. 


Error detected after an erase was attempted 
to recover a write error. 


ACTION 


Contact site operator 
to have MAGNET 
brought up. Otherwise 
contact central 
software support. 


Inform site analyst. If 
many of these errors 
occur, the site anlayst 
should perform a full 
PFDUMP, total INITIALIZE, 
and full PFLOAD on the 
device. 


Split job into two or 
more jobs and retry. — 


Increase central memory 
field length. 


Inform site analyst. 


Rerun the job. If the 
problem recurs, inform 
a site analyst, write 

a PSR and include 
support material so that 
CDC can duplicate the 
problem. 


Verify that the MAG. 
subsystem is running and 
rerun the job. If the 
problem recurs, inform 

a site analyst, write 

a PSR and include 
support material so that 
CDC can duplicate the 
problem. 


Reenter the command or 
rerun the job. If the 
problem recurs, inform 
your site analyst or 
contact Central Software 
Support. : 


No action necessary. To 
prevent the message from. 
recurring increase MFL 
specified in SETMFL 
macro to at least the 
minimum required for the 
MFL command. 


Examine program to 
determine why incorrect 


monitor request call is 
being made. 


None. 


Inform site analyst. 


ROUTINE 


LFM 
RESEX 


PFM 


TAJ 


4MA 


MFLINK 


RESEX 


RESEX 


RESEX 


CPM 


qAd 


AMT 


IMT 
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MESSAGE 


MT,Ccc,Eec,Hhhhhhhhh,BID RECOVERY-x. 


MT,Ccc,Eec,Hhhhhhhhh,BLOCK TOO LARGE. 


“MT, Ccc, Eee, Hhhhhhhhh ,BUSY. 


MT,Ccc,£ec,Hhhhhhhhh, CHANNEL ILL. 
MT,Cec,Eec,Hhhhhhhhh, CON. REJ. 


MT,Coc,Eec,Hhhhhhhhh,cON. REJ. MDI. 


MT,Ccc,Eec,Hhhhhhhhh,cON. REJ. OFF. 


MT,Ccoc,Eec,Hhhhhhhhh, ENf fff ,Pyyyy. 


MT,Ccc,Eec, Hhhhhhhhh, Lbbbb, Bnnnnnn. 


MT,Ccc,Eec,Hhhhhhhhh,LOAD CHECK. 
MT,Ccc,Eec,Hhhhhhhhh MARGINAL, DOWN. 


MT,Ccc,Eec,Hhhhhhhhh, MARGINAL, OFF. 


MT,Ccc,Eec,Hhhhhhhhh,No EOP. 


MT, Ccc,Eec,Hhhhhhhhh NOISE. 
MT,Ccc,Eec,Hhhhhhhhh,NOT READY. 
MT,Ccc,€ec,Hhhhhhhhh,ON THE FLY. 


MT, Coc, £ec,Hhhhhhhhh POSITION LOST. 
MT, Coc, Eec, Hhhhhhhhh, RECOVERED. 
MT, Coc, Eec,Hhhhhhhhh, STATUS. 


MT,Coc,Eec,Hhhhhhhhh,WRONG PARITY. 


"B16 


SIGNIFICANCE 


A single block mispositioning error was 
recovered by block ID recovery. If x is B, 
the error was caused by backspacing the 
tape too far; if x is F, the tape was not 
backspaced far enough. 


Data block is at least one byte Longer than 
length bbbb shown in third Line of message. 


Unit was still busy after one second. 


Channel is not accepting function for 
status requests properly. 


Connect reject; unable to connect to the 
unit. 


Connect reject; unable to connect to unit 
because of marginal detection indication 
(thermal warning). Unit turned off. 


Connect reject; unable to connect to unit. 
Unit turned off. 


Function ffff was rejected by the 
controller; yyyy is the address in IMT 
where the function was initiated. 


The Length (bbbb) and block number (nnnnnn) 
read from trailer bytes in block did not 
match the actual Length or the block number 
read given in previous message line. 


Load sequence failed on the unit. 


Indicates controller failure. Channel has 
been logically turned off and maintenance 
is required. 


Unit has been logically turned off because 
of read/write failure. This occurred when 
a special function to check the read/write 
path to a unit failed during initial Label 
scan. Maintenance is required. 


No end-of-operation detected from unit 
within 1 second. 


A noise block was skipped on the tape. 
Tape unit dropped ready status. 
Error was corrected as the data was read. 


The Last good block written cannot be found 
during write recovery. 


Previously reported error has been 
successfully recovered. 


Error type cannot be determined so actual 
controller status is returned. 


Tape was written in parity opposite that 
being read. 


None. 


None. 


Inform 


Inform 


Inform 


Inform 


Inform 


Inform 


None. 


ACTION 


customer engineer. 


customer engineer. 


site analyst. 


customer engineer. 


site analyst. 


site analyst. 


Push CLEAR button and 


reload 


tape, or inform 


site analyst. 


Inform 


Inform 


Inform 


None. 


customer engineer. 


customer engineer. 


customer engineer. 


Make unit ready. 


None. 


None. 


None. 


Inform 


None. 


site analyst. 


ROUTINE 


IMT 


IMT 


IMT 


AMT 
4MT 


IMT 


IMT 


AMT 


IMT 


IMT 


IMT 


IMT 


AMT 


IMT 
IMT 
IMT 


IMT 


IMT 


AMT 


AMT 


60459690 F 


MESSAGE 


MT,Ccc-e-uu,vsn,rw,est ,Ss ,GSgggggggg 


MT, Coc, Dddd.eeda 


MT,Ccc,Uuu...u,Ttttt. 
MT,Ccc,Aaaaaaaaa. : 
MT,Coc,Fff,1ii,Bnnnnnn,Lbbbb,Ppppppppp. 
MT,Ccc,£ec,Hhhhhhhhh, type. 

or. 
MT,Ccc~e-uu,vsn,rw,est,Ss,GSgggggggg. 
MT, Coc,Dddd. ..d. 
MT,Ccc,Aaaaaaaaa. Z 


MT,Ccoc,Fff,lii,Bnnnnnn,Lbbbb,Ppppppppp. 


MT,Ccc,Eec,Hhhhhhhbh type. 

or 
MT,Ccc,-e~uu,vsn,rw,est ,Ss ,GSgggqqggg. 
MT,Ccc,Dddd...d. : 
MT,Coc,Fff,11i,Bnnnnnn,Lbbbb,Ppppppppp. 
MT,Ccc,Eec,Hhhhhhhhh,type. 

or 
MT, Ccc~e-uu,vsn,rw,est,Ss,GSgggggggg. 
MT,Ccoc,Dddd...d. 
MT,Coc,Uuu...u,Ttttt. 
MT,Ccc, Ff f,1ii,8nnnnnn,Lbbbb, Ppppppppp. 
MT,Ccc,Eed,Hhhhhhhhh,type. 
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SIGNIFICANCE 


Four or five or six-line message describing 


a magnetic tape hardware malfunction on a 
66x or 67x tape unit. Message as 
illustrated indicates 7?-track, model 667 or 
677 unit. If NT appears in place of MT, 
message indicates 9-track, model 669 or 679 
unit. Message is issued to error log and 
dayfile. 


The first Line of each message provides the 
following information: 
¢c-e~uu Channel, equipment (tape 
controller), and physical 
unit number of tape unit on 
which error was encountered. 
vsn Volume serial number 
associated with tape on the 
specified unit. 
rw Read (RD) or write (WR) 
operation; any operation not 
involving an actual read or 
write is Listed as a read. 
est EST ordinal of the unit on 
which the tape was written. 
This .is provided only for 
labeled tapes generated 
under NOS; otherwise, the 
field is blank. 
s Channel status. 
ggggggg9 General status of magnetic 
tape unit. Last byte is 
block ID. a 
The MT,Ccc,Dddd...d Line of the message 
provides the following information: 
ce Channel number; the channel 
“number is repeated to allow 
the analyst to associate 
this message with the first 
message if errors are 
occurring on more than one 
tape channel at the same 
time. 

Detailed status of magnetic 

tape unit. 

The MT,Ccc,Uuu...u,Ttttt Line of the 

message provides the following information: 

cc Channel number; repeated to 
associate this message with 
the previous message. 

UUseet Detailed unit status. 

- . tttt Third byte of the tape unit 
format parameters (refer to 
the magnetic tape. subsystem 
reference manual for 
descriptions of unit format 
parameter fields). 

The MT,Ccc,Aaaaaaaa line (for FSC only) 

contains the additional sense byte 

status not placed in the detailed status 

or unit status fields. . 

cc Channel number. 
aaaaaaa Sense byte. 


ddd...d 


The MT,Ccc,Fff,...,Ppppppppp ‘Line of the 
message provides the following information: 
cc Channel number; repeated to 
associate this message with 
the previous message. 


ff Software function on which 
i the error occurred. 
ii , Error iteration; number of 


times error has been 
encountered on this unit 
without successful recovery. 


anannn . Block number on which error 
occurred. 
bbbb Length of block on which 
error occurred in octal 
bytes. 
PPpppppp 1MT internal error 
"| | parameters. 


ACTION ROUTINE 
Refer to the separate . 41MT 
Listing of the Last Line 
message (MT,...-,type.) 
for the appropriate 
action. 
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MESSAGE 


MT/NT CONFLICT. 


MULTI-FILE NOT FOUND, filename AT address. 


« 


NETWORK TYPE DOES NOT SUPPORT ATTRIBUTE 
COMMAND. 


NO EXTENDED MEMORY. 


NO INPUT FILE FOUND. 
NO MASS STORAGE AVAILABLE. 


filename - NO TEMP DEVICE FOUND. - 


NO WRITE ENABLE, fitename AT address. 


NON-MATCHING CONVERSION. 
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SIGNIFICANCE 


The Last Line of each message provides the - 


following information: 

ec Channel number; repeated to 
associate this message with 
the previous message 

ec Octal error code value. 

hhhhhhhh Parameters passed to the 
tape unit for the format 
function (refer to the tape 
drive's hardware reference 
manual for descriptions of 
the unit format parameter 
fields). 

type Additional description of 
the error. Refer to 
individual listing of the 
last Line message. 


Conflict exists between 7-track and 9+track 
tape descriptors (track type, density, and 
conversion mode). For example, a request 
for a 9-track tape specified 200 bpi 
density. This message can also be issued 
if the device type specified in FET+1 
conflicts with the track type specified in 
bit 56 of FET+10 octal. If dt=MT and bit 
56 is set, the message is issued. 


Either LISTL8 has reached: the ‘end of the 
multifile set or the requested file was not 
found. , The following additional messages 
are also given: 

~ REQUESTED SECTION xxxx. 

- FOUND SECTION yyyy. or 

- FILE IDENTIFIER NOT FOUND. 

The filename, address, xxxx, and yyyy given 
can be ignored. 


You attempted to enter NAM/CDCNET command 
from a NAM/CCP connection. 


A DMPECS or DMDECS command or DED or DEP 
request was entered and no extended memory 
field length is assigned to you. 


No valid input file exists; functions 
cannot be performed. 


No mass storage space of the requested 
type could be found. 


You attempted to create a local copy of an 
indirect access permanent file, but the 
file's access level was not within the 
range of valid access levels for any active 
temporary storage device. 


Either you attempted to write on a tape 
mounted with no write ring, or no write was 


allowed because of additional constraints 


described in an additional message Line. 


Informative message indicating conversion 
mode on labeled 9-track tape differs from 
that specified by assignment request. 
System writes tape in specified mode, or 
reads tape with write ring out in correct 
mode. However, reading tape with write ring 


in or using wrong conversion mode generates. 
conversion errors. 


ACTION 


Ensure accuracy of 
command. 


If LISTLB reached the 
end of the multifile 
set, the operation is 
complete and no action 
is required. Otherwise, 
ensure that the correct 
tape is being used and 
that it contains the 
desired file(s). ALL 
label parameters must 
match in order to 
position to the 
specified file. 


Be sure that you enter 
only NAM/CCP commands 
from a NAM/CCP 
connection. 


None. 


Verify that input file 
is present. 


Retry later. 


Inform security 
administrator. The 
security administrator 
needs to configure the 
system so that temporary 
devices are available 


- for all valid access 


levels. 


If no additional message 
Line appears, ensure the 
inserting of a write 
ring by specifying the W 
processing option on the 
tape request (for 
example, PO=W on the 
LABEL command). 
Otherwise, refer to the 
description of the 
message in the 
additional message line. 


If reading tape with 
write ring in, return 
and reassign with 
correct conversion mode. 


ROUTINE 


RESEX 
BLANK 


i. & 


TRMDEF 


CPMEM 


QFM 
LFM 


PFM 


4MT 


RESEX 
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MESSAGE 


NON-MATCHING DENSITY. 


NORERUN/RERUN INCORRECT FROM INTERACTIVE 
JOBS. 


filename NOT FOUND. 
or 
username NOT FOUND. 


filename NOT IN WRITE MODE. 
filename NOT ON MASS STORAGE. 
filename NOT ON MASS STORAGE. 


NOT VALID TO DOWNGRADE DATA. 


‘NOT VALIDATED FOR REQUESTED ACCESS LEVEL. 


NOT VALIDATED FOR REQUESTED APPLICATION. 


NOT VALIDATED FOR WRITING UNLABELED TAPES. 


- NOT VALIDATED TO SET XD/XT. 


ONLY CORRECT PARAMETERS ARE *ON* OR *OFF*. 
OPERATOR DROP. 


OPERATOR KILL. 


OPERATOR OVERRIDE. 


OVERLAY FILE EMPTY. 
OVERLAY FILE NOT FOUND. 


OVERLAY LOST. 
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SIGNIFICANCE 


Informative message indicating that the 
density specified on the command or macro 
is not the same as the density of the 
assigned tape. Issued only to 9-track 


. tapes with write ring out. 9-track tapes 


are read at the current density on tape. 
They are written at specified density if 
write initiated from load point; otherwise, 
tape is written at the current density on 
the tape. 


You entered a NORERUN or RERUN command from 
an interactive terminal. The command is 
ignored. 


One of the following: 

- The specified permanent file could not 
be found. ‘ 

- The specified user name could not be 
found. 

- You are not allowed to access the 
specified file. 

- The specified local file could not be 
found. 


The file specified in an OVWRITE command or 
macro was not processed because you do not 
have write access to it. 


The file to be saved is not on mass 
storage; the first track of the file is not 
recognizable. 


The file specified in an OVWRITE'’ command or 
macro was not processed because it does not 
reside on mass storage. : 


You attempted to lower the access level of 
a permanent file, but you are not validated 
to downgrade files. 


User has specified an access Levet outside 
the user's access level validation. 


You submitted an APPSW command specifying 
an application for which you are not 
validated. ‘ 


User has not been validated for writing on 
unlabeled tape. 


You specified an XD or XT parameter in a 
CHANGE, DEFINE or PERMIT command or macro 
without having: validation to use these 
parameters. 


The parameter you specified was not 
recognized. 


Informative message indicating that the 
operator dropped the job. 


The operator entered a KILL command to drop 
the job. This disallows erexit 

processing. A job with extended reprieve 
processing is reprieved once. Exit 
processing is allowed. 


The operator entered an OVERRIDE command to 
drop the job. This disallows exit, erexit, 
and reprieve processing. 


No data- appears in the requested file. 
The specified file was not available. 


The specified overlay was not found. 


ACTION 


None. 


None. 


Verify that file name/ 
user name is correct, 
that access permission 
has been granted, and 
that correct access is 
being attempted. 


Correct and retry. 


Verify that file is on 
mass storage. 


Correct and retry. 


None. 


Use a validated access 
level, or site must 
validate user for 
additional access level. 


Enter a LIMITS command 
to check your current 
validations. If you 
require validation for 
additional applications, 
see your site 
administration. 


Either use Labeled tape 
or site must validate 
user for SAV=CULT MODVAL 
privilege. 


Retry without XD or XT 


parameter, or obtain 
validation and retry. 


Check command 
description and retry. 


None. 

Correct job as needed 
and rerun. 

Correct job as needed 


and rerun. 


Verify that overlay file 
is valid. 


‘Verify that file is 


local to job and retry. 


Inform software support. - 


ROUTINE 


RESEX 


QFM 
CONTROL 


PEM 


4Ms 


PFM 


4MS 


PFM 


RESEX 


_ TLX 


RESEX 


PFM 


CONTROL 


1AJd 


4AS 


1AJ 


1AJ 


1A 


- Ad 
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MESSAGE 


OVERLAY NOT FOUND. 


OVERLAY NOT FOUND IN LIBRARY —- oviname. 


PARAMETER BLOCK BUSY. 


PARAMETER *ON* OR *OFF* REQUIRED. 


PARAMETERS *ON* AND *OFF* ARE MUTUALLY 


EXCLUSIVE. 


PARITY ERROR, JOB HUNG. 


pfn PERMANENT ERROR. 


PERMIT LIMIT EXCEEDED. 


PF STAGING DISABLED. 


PF UTILITY ACTIVE. 


“oa 


PFM ARGUMENT ERROR. 


PFM EXCESS ACTIVITY. 


PFM INCORRECT REQUEST. 


PL ERROR IN DECK. 


POSITION ERROR ON-fiLename. 


POSITION LOST, filename AT address. 
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SIGNIFICANCE 


The specified overlay was not found. 


The overlay ovlname was not found in the 
system Library. : 


The completion bit of the parameter block 
was not set to one before the monitor 
request was made. 


No parameter was specified on ERRMSG 
command. 


You specified both the ON and OFF 
parameters on the same command. Only one 
is allowed. 


A CM parity error occurred in the jobs 
field length. The job is hung to freeze 
the affected area. 


The specified direct access file resides on’ 


alternate storage and has data errors that 

must be corrected. The error flag must be 

cleared or the file must be reloaded from a 
backup copy. 


A PERMIT command or macro cannot be 
Processed because the file specified 
already has the maximum number of permits 
allowed. 


The specified direct access file cannot be 
accessed since it resides on the Mass 
Storage Facility (MSF) and the site has 
temporarily disabled all MSF file staging. 


The operation was not attempted because a 
permanent file utility was currently active. 


One of the following conditions is true: 

- The PFM call block is outside of the 
job's field Length. 

- An incorrect command code was specified. 

- Auto recall was not set when PFM was 
called. 


The PFM activity count for your permanent 
file family is currently at its Limit. 
This condition is reported to the 
requesting program only if both ep and up 
processing options are set. 


One of the following occurred: 

- A privileged command was requested by a 
nonvalidated program. 

- An incorrect backup requirement, 
preferred residence, or subsystem value 
was entered. 

- Incorrect command code, passed to PFM. 

~ Incorrect permit mode or catalog type 
specified. 

- The FET for a file specified in a 
SETPFAC request was less than six words 
long. 


The program Library specified by the P 
option in the KRONREF command was 
incorrectly formatted. 


File filename was not repositioned after 
being checkpointed because CHKPT detected 
an address error. 


During write or read error recovery, the 
system could not find the Last good block 
of data, making it impossible to 
successfully perform error recovery. 

Labels are not written after this error and 


- existing data on the tape is not destroyed. 


ACTION 


Verify that the file 
with the specified 
overlay is local to the 
job. 


Verify that call is to 
valid overlay. 


Set completion bit 
before making monitor 
request call. 


Retry with a parameter. 


Retry with either ON or 
OFF. 


Inform software support. 


Inform site analyst. 
The site analyst may 

be able to correct the 
problem with ASDEBUG or 
SSDEBUG; otherwise, the 
file must be purged or 
reloaded. 


None. 


Determine from site 
operator when MSF file 
staging will resume and 
retry the job at that 
time. 


Wait until PF utility is 
not active and’ retry. 


Correct your program 
to call PFM properly. 


Retry operation Later. 


Verify that the PFM 
request is valid. 


Check that the PL is a 
MODIFY OPL. 


None. 


Retry operation on 
different tape or tape. 
drive, if possible. 
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ROUTINE 


TAJ 


LDR 


LFM 


CONTROL 


to 


CONTROL 
4AJ 


PFM 
PFM S 
PFM 


PFM 


PEM 


PEM 


PFM 


KRONREF 


CHKPT 


~ AMT 


MESSAGE 


PP CALL ERROR. 


PRIOR TAPE ASSIGNMENT LOST. 


PROCESSOR DETECTED MALFUNCTION 


PROCESSOR STATE ERROR 


PROGRAM STOP. 


PROGRAM STOP AT address. 


“PRU LIMIT, FILE filename AT address. 


PRUS REQUESTED UNAVAILABLE. 


QAC BUFFER ARGUMENT ERROR. 


QAC INCORRECT PARAMETER BLOCK SIZE. 


QAC INCORRECT QUEUE ORDINAL. 


QAC INCORRECT REQUEST. 


QAC REQUEST COMPLETION BIT SET. 


QFM ARGUMENT ERROR. 


QFM BUFFER ARGUMENT ERROR. 


QFM FILE NAME ERROR. 
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SIGNIFICANCE 


The monitor detected an error in a CPU 
request for PP action. 


Magnetic tape executive has been dropped 


along with tdpes assigned. ALL of the 
job's prior tape assignments are lost. 


A hardware error occurred such as a data or 


..address parity error on double bit error. 


A hardware error, or software error 
resulting in a hardware error, occurred. 


The system processed a program stop (00) 
instruction. 


The monitor detected a program stop 
instruction at the specified address. 


The job's mass storage PRU Limit was 
exceeded during an attempt to write or 
extend this file. 


On a DEFINE, no device currently has 
available the amount of space requested by | 
the-S parameter. On a secured system, no 
device with the proper access level 
currently has the amount of space. requested. 


The address in one of the @ac buffer fields 
(first, in, out, or Limit) is incorrect. 


The value of the Len field 6f address+1 is 
incorrect for the requested function. 


_The ordinal in the ejt/qft ord field of 


address+4 is out of range for the specified 
queue. 


One of the following occurred: | 

- An undefined function code was entered 
in address+0. 

- An incorrect address was entered in 
monitor request or the Link address 
field in address +108, on the QAC. 
parameter block. : 

- The range of security access levels 
specified was not within the job's 

* security access level limits. 

- The new security access level: specified 
in an ALTER request was not within the 
security access level limits for the 
file's origin type, or is not allowed on 
the. device where the file resides. 

- An ALTER request to change the access 
level of a queued file was made by a 
user without security administrator 
privileges. 


The completion bit in address+0 was set for 
the request. 


One of the following: 

- Address is outside field length. 
- Address is equal to 1. 

- Origin code is out of range. 

ID code is out of range. 


A buffer pointer did not conform to the 
following constraints: 

- FIRST .LE. IN 

- FIRST .LE. OUT 

- OUT .LE. LIMIT .LE. FL 


The filename specified is not a valid file 
name. 


ACTION 


Verify that correct PP 
call is issued. 


From an interactive job, 
return/unload all prior 
tapes and reassign. A 
batch job aborts and 
must be rerun. 


Analyze job dumps, . 
maintenance registers 
and the error log to ° * 
determine cause. 


Analyze job output, 
dumps, Listings, 
maintenance registers 
and the error log to 
determine cause. ~ 


None. 
None. 


Return one or more local 
files and retry. 


If possible, reduce the 
number of PRUs specified 
by the S$ parameter, or 
retry at another time 
when space might be 
available. 


Ensure that alt four 
addresses are within the 
job's field length. 


Correct the len field or 
the function code. 


Enter a vatid EJT or QFT 
ordinal. 


Enter a valid function 
code, level(s), address, 
or access. 


Clear the completion bit. 
Verify that QFM request: 


is valid. 


Examine program to 
determine error in 
buffer pointers. 


Verify file name. 


ROUTINE 


1AJ 


RESEX 


1AJ 


qAS 


1AJ 


1AJ 


IMS 


PEM 


Qac 


Qac 


QACc 


QACc 


QAC 


QFM 


QFM 


QFM 
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MESSAGE 


QFM 1/0 SEQUENCE ERROR. 


QFM INCORRECT EQUIPMENT. 
_ G@FM INCORRECT QUEUE FILE ORDINAL. 


QFM INCORRECT REQUEST. 


QFM USER ACCESS NOT VALID. 


RANDOM ADDRESS NOT ON FILE filename AT 
address. 


RANDOM INDEX ERROR. 


READ AFTER WRITE, filename AT address. 


READY DROP, filename AT address. 


REPLACE ERROR. 


REPRIEVE BLOCK ERROR. 


REPRIEVE CHECKSUM BAD. 


REQUEST IS VALID ONLY FROM A NETWORK 
TERMINAL. 


REQUEST #*K*. DISPLAY. 


REQUEST UNDEFINED ON DEVICE, filename AT 
address. 


RESEX ABORT - OPERATOR TERMINATION, 
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SIGNIFICANCE 


Action was requested on a busy file. 


The equipment specified in FET+7 either is 
not mass storage or is not in the range of 
the EST. 


The QFT ordinal of the file to be attached 
is out of range. 


One of the following: 

- Specified function was incorrect or 
unde fined. 

- Job did not have SSJ= entry point. 

- Auto recall bit was not set. 


The user tried to perform an operation for 
which he is not validated (for example, 
attempting to run a system origin job from 
nonsystem origin). 


The random address specified was not within 
the bounds of the file. The system 
provides a dump of the FET on file OUTPUT. 


The random disk address of the permit 
sector is in error (error log and dayfile 
message). This may be a problem with 

your program. : 


You attempted to read a tape on which the 
last operation was a write. 


Unit dropped ready status. 


The same file was found twice during a 
catalog search. This error can occur for 
APPEND or REPLACE commands or macros after 
a file is found and purged and the catalog 
search is continued (error log and dayfile 
message). 


An address is out of range or there is an 
incorrect. parameter in the reprieve 
parameter block at the time of an error. 
The message is also issued if the specified 
reprieve address itself is out of range. 
(1AJ issues this message for all errors 
except terminal interrupts processed by 
IRI.) 


The. computed checksum does not agree with 
the checksum specified in the parameter 
block at the time of the error. (1AJ 
issues this message for all errors except 
terminal interrupts processed by 1RI.) 


You attempted to enter an APPSW command 
from a job that was not of interactive 
origin type or from a terminal not 
connected to NAM (for example, through 
RDF). To use the APPSW command, your job 
must be of interactive origin type and your 
terminal must be connected to NAM. 


Issued by function 5 (Set Console Display 
Register) to DSD B and J displays when 
Operator action is requested. 


The specified function cannot be performed 
on the device on which the file resides. 
The system provides a dump of the FET on 
file OUTPUT. 


The operator entered a DROP, KILL or RERUN 
command, setting an error flag in RESEX. 
RESEX performed appropriate cleanup 
procedures before termination. 


ACTION - 


Wait until file is not 
busy and retry. 


Verify that correct 
equipment is specified 
in FET+7. 


Ensure that the routine 
calling Q@FM supplies the 
correct ordinal. 


Verify that valid QFM 
request is being made. 


Ensure accuracy of 
command or macro or 
determine proper 
validation 
requirements. 


Verify that random 
address is correct. 


Check your program. If 
it does not use the 
CATLIST macro, inform 
site analyst. : 


Ensure accuracy of tape 
positioning commands 
(BKSP, BKSPRU, SKIPFB, 
or REWIND required to 
read after write). 


None. 


Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 


PFDUMP, total INITIALIZE, 


and full PFLOAD on the 


device. 


Ensure parameter block 
is correct. 


Ensure interrupt handler 
is still intact. Ensure 
that code in the area 
for which checksum was 


computed has not changed. 


Login to IAF from a 
terminal connected to 
NAM. 


Refer to DSD K display. 


Verify that valid device 
is specified. - 


Determine. reason for 
operator action. Rerun 
job if possible. 


ROUTINE 


QFm 


Qrm 


QF 


QFm 


QFM 


IMS 


PEM 


AMT 


AMT 


1AJ 


1AJ 


TLX 


CPM 


IMS 


RESEX 
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MESSAGE 


RESEX ABORT ~ SYSTEM RESOURCE LIMIT. 


RESEX ABORT - TERMINAL INTERRUPT. 


RESEX FAILURE. 


RESOURCE ENVIRONMENT ERROR. 
RESOURCE NEGATIVE SHARE COUNT. 


RESOURCE PF ERROR ec filename. 


RESOURCE SCRATCH FILE ERROR. 


@ RETRY APPLICATION SWITCH. 


RFL BEYOND MFL. 


ROLLOUT FILE BAD. 


RPV-ADDRESS OUT OF RANGE. 


RPV-CALLED WITHOUT AUTO-RECALL. 


RPV-INCORRECT CALL. 
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“SIGNIFICANCE 


RESEX terminated prematurely due to job 
time Limit, SRU Limit, or track Limit. 
RESEX performs appropriate cleanup 
procedures before termination: 


Terminal user interrupted RESEX (interrupt 
or terminate sequence). RESEX performs 


appropriate cleanup procedures before 
termination. 


The resource executive (RESEX) has detected - 


a fatal error. 


Dayfile message indicating RESEX internal 
problem occurred (internal environment 
building failed due to MST, UDT, or EST 
errors). 


Dayfile message indicating that a RESEX 
internal problem occurred. The resource 
overcommitment algorithm indicates a | 
greater number of users are sharing a 
removable pack than are actually sharing 
the pack. 


PFM error ec occurred when attaching 


* resource file filename. 


Dayfile message indicating RESEX internal 
problem has occurred. An empty entry has 
been found in. the overcommitment algorithm 
scratch ‘file. 


An attempt to. switch applications failed 
due to software error. 


The RFL request is greater than the maximum 
field length for a job step. 


A job could not be rolled out correctly. 


An address provided to RPV was out of 
range. This includes the following 
conditions: 

- FWA of parameter block .GE. FL 

- LWA of parameter block .GE. FL 

- Transfer address .GE. FL 

- Transfer address .LT. 2. 


An extended RPV mode call was made without 
auto recall. 


One of the following: 

- An. attempt was made to do a reset when 
no previous error existed'or the 
previous error was pending. 

- An extended mode call was attempted when 
nonextended RPV or DISTC had already 
_been set for the job. : 

- A nonextended mode call was attempted 

- when RPV extended mode had already been 
set in for the job. 


- A call was made to clear extended 
“reprieve and. there were pending 
interupts present. 


ACTION 


If error caused by SRU 


“or time Limit, increase 


resource Limits. If 
caused by track Limit, 
contact site analyst. 


None. 


“Write a PSR. 


Reenter the command or 
rerun the job. If the 
problem recurs, inform 
your site analyst or 
contact Central Software 
Support. 


Reenter the command or 


- rerun the job. If the 


problem recurs, inform 
your site analyst or 
contact Central Software 
Support. 


Rerun the job. If the 
problem recurs, inform 
a site analyst, write 

a PSR and include 
support material so that 
CDC can duplicate the 
problem. 


Rerun the job. If the 
problem recurs, inform 
a site analyst, write 

a PSR and include 
support material so that 
COC can duplicate the 
problem. , 


Retry the APPSW 

command. If the error 
recurs, inform your site 
analyst. 


Increase maximum field 
length with MFL command 
or SETMFL macro. 


Inform site analyst. 
Check error log dayfile 
for the job that was 
aborted and the location 
of the bad rollout. file. 


Check all addresses sent 
and ensure that they are 
within range. 


Ensure that auto recall 
bit is set. 


- Check to see if a 
reset is allowed. 

- If RPV nonextended 
mode has already been 
used, then RPV 
nonextended mode 
cannot be used in the 
same job. 


- Clear pending interrupt 


before calling RPV. 

- If RPV extended mode 
has already been 
.used, then RPV 
nonextended mode 
cannot be used in the 
same job. 


f£% 


ROUTINE 


RESEX 


RESEX 


PFM 


RESEX 


RESEX 


RESEX 


RESEX 


TLX 


CPM 


IRI 


RPV 
to RPV 


RPV. 


RPV 
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MESSAGE 


RPV-INCORRECT FUNCTION CODE. 


RPV-INCORRECT PENDING INTERRUPT. 


RPV-INCORRECT PENDING RA+1 REQUEST. 


RPV-LWA OF CHECKSUM .LT. FWA. 


RPV-PARAMETER SLOCK TOO SHORT. 


RPV-UNDEFINED MASK, 


SCP INCORRECT TRANSFER ADDRESS. 


SECONDARY APPLICATION ABORTED CONNECTION. 


SECONDARY APPLICATION CONNECTION LIMIT. 
SECONDARY APPLICATION FAILED. 
SECONDARY APPLICATION NETTED OFF. 


SECONDARY APPLICATION NOT AVAILABLE. 


SECONDARY APPLICATION PROCESSING COMPLETE. 


SECONDARY APPLICATION REFUSED CONNECTION. 


SECURE FILES - CHECKPOINT ABORT. 


SECURE MEMORY, DUMP DISABLED. 


SECURITY CONFLICT. 
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SIGNIFICANCE 


The function code specified in the 
parameter block was incorrect. 


A bit was set in the pending interrupt word 
of the parameter block which did not 
correspond to a defined error. 


The pending monitor request field of the 
parameter block contained an incorrect 
monitor request on a RESUME or SETUP. On a 
RESET, the pending monitor request is not 
validated because the job will not be 
restarted, : 


The last word address of the checksum was 
less than the first word address. 


The length specified in the parameter block 


was less than 31B words. 


The mask specified in the parameter block 
is not a legal mask. 


The SCP SSCR (RA + 51B) word contains 
incorrect parameters on the completion 
address for an SF.REGR, SF.SWPI or SF.SWPQ 
function is no longer within the SCP field 
Length. 


You intentionally or unintentionally 
aborted the secondary connection. Possible 
causes are security conflict or entry of a 
BYE,ABORT command. 


The.-application you specified on an APPSW 
command is busy with the maximum allowable 
number of terminal connections. 


Your secondary application has failed, 
probably due to a system problem. 


The application was brought down by the 
network operator. 


The secondary application requested on an 
APPSW command is either temporarily 
unavailable or is not supported at your 
site. 


The connection to your secondary 
application has been terminated normally. 


The application refused to accept your 
connection, possibly as a result of a 
validation problem or security conflict. 


Indicates a local file being checkpointed 
had secure file status set. 


You either attempted to dump memory 
protected by the system, or entered a 
memory dump request after a protected - 
command. 


An attempted operation within the job would 
have resulted in a violation of security 
access levels or categories. The cause is 
described in the immediately preceding 
dayfile message. 


ACTION 


Function code in 
parameter block must 
equal 1 for setup, 2 for 
resume, or 3 for reset. 


Check parameter block to 
ensure that all bits set 
correspond to a defined 

error. 


Check pending monitor 
request word in 
parameter block to 
ensure that it contains’ 
a valid call. 


Correct and rerun. 


Ensure that the length 
specified in the 
parameter block is 
greater than or equal to 
318. 


Check mask set in 
parameter block to 
ensure that it is a 
valid mark. 


Correct code error in 
scp. 


If the abort was 
unintentional and you 
cannot establish a 
cause, see your site 
analyst. 


Try again later. 


Check with your site 
analyst or try again 
later. 


Check with your site 
analyst or try again 
later. 


Check with your site 
analyst. 


None. 


Check with your site 
analyst. 


None. 


Réfer to Security 
Control’ in NOS Reference 
Set, Volume 3, or user 
Field Length Dump Request 
Volume 4. 


Correct and retry. 


ROUTINE 


RPV @ 


RPV 


RPV 


RPV 


RPV 
4AJ @ 
TLX 


TLX en 
TLX 

TLX 

TLX 

TLX : @ 

TLX 


CHKPT 


TAJ 


1 . 
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MESSAGE 


SECURITY VIOLATION ON FILE filename AT 
address. 


SFM ARGUMENT ERROR. 


SFM BML MESSAGE LENGTH ERROR. 
SFM - DAYFILE BUSY. 

SFM DIRECT ACCESS FILE ERROR. 
iy DUPLICATE FILE FOUND, 

SFM FILE NAME ERROR. 

SFM FILE NOT ON MASS STORAGE. 
SFM FNT FULL. 

SFM 1/0 SEQUENCE ERROR.” 

SFM INCORRECT DAYFILE CODE. 
SFM INCORRECT EQUIPMENT. 

SFM INCORRECT FILE. TYPE. 


SFM INCORRECT ‘REQUEST. |. 


SFM TRACK INTERLOCK ERROR. 


SFM UNABLE TO INTERLOCK DEVICE. 
SFM - UNCORRECTABLE RMS ERROR. 


jsn SHARE TABLE MISMATCH. 


SI CODED FORMAT INCORRECT. 


SL NOT. VALIDATED. 


STACK PURGING NOT DESELECTAGLE. 


pfn STAGE INITIATED. 


. 
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SIGNIFICANCE 


One of the following: 

- You issued an OPEN request that 
specified an access level for a file 
that is not valid for your job. 

- You attempted to write on a direct 
access permanent file whose access 
level is lower than that of your job. 


_ One of the following occurred: 


- The argument passed to SFM was out of 
range or the FET’ specified did not 
specify a buffer of at least. 1008 words. 

- The EST ordinat specified is undefined 
in the system. 


The specified BML message length is zero or 


greater than six. -Legal values for Length 


are one through six. 
Action was requested on a busy dayfile. 


An error was encountered in the system 
sector of a direct access file. 


The requested file is already attached to 
the control point. 


The file name, filename, passed through the 
FET is not a valid file name. 


The specified file does not reside on a 
mass storage device. 


A fast attach file could not be created 
because the FNT was full. 


Action has been requested on a ‘busy file. 
The dayfile code passed in the FET was not 
within range. ; 


The specified equipment is not in the EST 
or is not mass storage. 


_ The file must be local for system file 


and direct access for a fast attach file. 


One of the following occurred: 

- The requested function or origin type 
specified in the function call was not 

- recognizable or SFM request was made and 

the auto recall bit was not set. 

- The request required an SSJ= entry point 
or subsystem ID, but. none was present. 

. Pr 
Track was either interlocked when it should 


“not have been or not interlocked when it 


should have been. 


SFM request was not performed because the 
selected device could not be interlocked. 


An uncorrectable RMS error has been 
detected during an I/0 operation. 


Dayfile message indicating that RESEX 
internal problem occurred. While 
processing the job with the specified job 
sequence name. 


An attempt was made to perform a read or 
write operation on an SI tape with the 
coded bit set in the FET. 


The SRU Limit requested exceeds that for 
which you are authorized. 


You attempted to change the purging bit 
with the EREXIT function. This cannot be 
done on 6000 or CYBER 70 systems. 


The file does not reside on disk. It is 
currently being staged from ‘alternate 
storage to disk. 


ACTION 


Set the access level of 
the file to the correct 
value and retry. 


Verify that SFM request 
is valid. 


Specify a valid message 
Length. 


Inform site analyst. 


Inform site analyst. 


Specify a unique file 
name. 


Specify a valid file 
name, 


Specify a mass storage 
file. : 


Retry operation at a 
later time. 


Wait until file is not 
busy and retry. 


Inform site analyst. 


Specify a valid mass 
storage equipment. 


Specify a file of the 
correct file type. 


Verify that SFM request 
is valid. f 


Contact Central Software 
Support. : 


Contact Central Software 
Support. 


Contact Central Software 
Support. 


Reenter the command or 
rerun the job. If the 
problem recurs, inform 
your site analyst or 
contact Central Software 
support. 


Resubmit the job with 
binary specified for the 
operation on the SI tape. 


Request smaller SRU 
Limit. 


None. 


Wait until stage 
operation is complete. 


ROUTINE 


4MsS 


SFM 


SFM 
SFM 
SFM 
SFM 
SFM 
SFM 
SFM 
SFM 
SFM 


SFM 


. SFM 


SFM 


SFM 


SFM 


SFM 


RESEX 


IMT 


CPM 


cPmM 


PFM 
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MESSAGE 


STATUS ERROR, filename AT address. 


STEP CONDITION. 


SUBSYSTEM ABORTED. 


| SYSTEM ABORT. 


SYSTEM CHECKPOINT ABORT. 


SYSTEM ERROR. 


SYSTEM ERROR. 


SYSTEM ERROR. 


SYSTEM SECTOR ERROR. 


SYSTEM SOFTWARE RERUN THRESHOLD EXCEEDED 


TAPE FORMAT PROBABLY WRONG, 


THIS CONNECTION IS ALREADY LOANED. 


TIME LIMIT. 


TL NOT VALIDATED. 


TLX —- ARGUMENT ERROR. 
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SIGNIFICANCE 


An error was encountered during magnetic 
tape processing. A second message Line 
describes the error in more detail. 


Step mode flag set in the PSD register 
caused the program to interrupt at the end 
of a program instruction with an exchange 


. jump to EEA (the error exit address in the 


exchange package). 


Your job was connected (either long term 
connection or wait response set) to a 
subsystem which aborted. 


Possible causes include the following: 

- Incorrect USER command. 

- Attempt to access a restricted subsystem. 

- Operator evicted job. 

- Unrecognizable error flag. 

- SSJ= block outside field Length. 

- RI detected a bad rollout file. 

- 1RO detected an unrecoverable extended 
memory parity error during rollout of a 
job's extended memory field Length. 


A subsystem has aborted due to a CHECK 
POINT SYSTEM request initiated by the 
operator. 


A software or hardware system error 
occurred. This message follows a 
more specific message in the 
dayfile. 


LFM cannot complete the requested LFM 
function because the calling program has a 
DMP= entry point. 


Requested function cannot be completed 
because the calling program has a DMP= 
entry point. 


The system sector of an indirect access 
permanent file contains an error (error log 
and dayfile message). This indicates that 
the file has been destroyed. 


A job will be rerun a maximum of n-1 times 
due to a hardware error. The default for n 
is 2 (defined by HRTL in common deck 
COMSMSC). 


This message is issued in addition to one 
of the following messages: 

~ BLOCK SEQUENCE ERROR, filename AT addr. 
~ BLOCK TOO LARGE, filename AT addr. 

= WRONG PARITY, filename AT addr. 


This error indicates an abnormal condition 
is occuring in IAF. 


The execution time Limit for a job step 
expired resulting in job termination. 


The time Limit requested exceeds that for 
which you are authorized. 


The specified function parameter address is 
out of range. 


ACTION 


Retry or inform site 
analyst. 


Inform site analyst. 


Retry later. 


If the cause was an 
incorrect USER command 
or an attempt to access 
a restricted subsystem, 
correct the job and 
rerun. Otherwise, 
inform a site analyst. 


None. 


Refer to action for 
the associated 
message. 


Inform site analyst 
or write a PSR and 
include support 
material so that 
CDC can duplicate 
the problem. 


Contact Central Software 
Support. 


Inform site analyst. If 
many of these errors 
occur, the site analyst 
should perform a full 
PFDUMP, total INITIALIZE, 
and full PFLOAD on the 


_ device. 


Analyze job output, 
dumps, and listings to 
determine cause. 


Ensure accuracy of 
format (F) parameter on 
command or macro. 


Inform site analyst. 


If a time Limit was set 
for the job, include a 
SETTL command requesting 
a longer time Limit for 
the job step. If the 
job step time Limit was 
the maximum for which 
you are validated, 
request a Larger time 
Limit or decrease the 
amount of processing to 
be performed by the job 
step. 


Request smaller time 
Limit. 


Specify a valid 
parameter address. 


ROUTINE 


MT 


TAS 


1AJ 


1AJ 


1CK 


MODVAL 
PFM 


BLANK 
RESEX 


LFM 


PEM 


1AJ 


IMT 


TLX 


1AJ 
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MESSAGE 


TOO MANY PERMANENT FILES. 


TOO MUCH INDIRECT ACCESS FILE SPACE. 


TOTAL ASSIGNED COUNT ERROR. 


TOTAL DEMAND COUNT ERROR. 


TRACK LIMIT. 


TRACK LIMIT, LVLX. 


TRAILER BLOCK COUNT ERROR, filename AT 
address. 


UNIDENTIFIED PROGRAM FORMAT. 


UNIT HUNG UP ON EOP OR BUSY, filename AT 
address. 


UNNECESSARY CIO FCT.-nmn ON filename AT 
address. 


UNRECOGNIZED TERMINAL MODEL. 


USER ACCESS NOT VALID. 


USER ACCESS NOT VALID. 


USER ACCESS NOT VALID. 


60459690 F 


SIGNIFICANCE 


The number of files in your catalog exceeds 
your Limit. 


The cumulative size of the indirect access 
files in your catalog exceeds your Limit. 


Dayfile message indicating RESEX internal © 
problem (sum of individual resource’ 
assigned counts differs from total assigned 
count in demand file entry). 


Dayfile message indicating RESEX internal 
‘problem occurred (sum of individual 
resource demand counts differs from total 
demand count in demand file entry). 


No allocatable tracks remain on your 
permanent file equipment (error log and 
dayfile message). 


IMS is waiting for temporary file mass 
storage space on any mass storage device 
with access level LVLX. 


The block count in the EOF1 or EOV1 Label 
did not match the block count maintained by 
the tape executive during the read 
operation. 


The file you requested to be loaded was in 
an unrecognizable format. 


Unit did not receive EOP on unit busy. 
? 5 


The read or write C10 function specified by 
nnn was unnecessary, since your I/0 buffer 
was already full (read) or empty (write) 
and no data could be transferred for this 
C10 call. The message is issued to the job 
dayfile only if analyst logging is enabled 
on the system (console entry). 


You entered an invalid terminal model 
Mnemonic as a parameter in the SCREEN 
or LINE command. 


You tried to perform an operation for which 
you are not authorized. Possible causes 
include attempts to access a file or 
equipment which you are not authorized to 
access. 


You tried to perform an operation for which 

you are not authorized. Possible causes . 

include ‘attempts to 

~ Run a system origin job from nonsystem 
origin. 

~- Access a restricted subsystem without 
proper validation. 

~- €nter an incorrect SRU vatue. 

- Use the. V carriage control character 
without validation. 


The user name or password could not be 
validated, or a secondary USER command was 
encountered while secondary USER commands 
were disabled. 


ACTION 


Purge one or more 
permanent files to 
allow you to 

save or define - 
additional files. 


Purge or shorten 
one or more indirect 
access files to 
allow additional 
permanent file space. 


Reenter the command or 
rerun the job. If the 
problem recurs, inform 
your site analyst or 
contact Central Software 
support. 


“Reenter the command or 


rerun the job. If the 
problem recurs, inform 
your site analyst or 
contact Central Software 
Support. 


None; job will con- 
tinue as tracks 
become available. 

If problem persists,’ 
contact central 
software support. 


Inform site analyst. 


Inform site analyst. 


Check the format of the 
file. 


Inform site. analyst. 


Ignore or correct 
program to be more 
efficient. 


Retry with valid 
mnemonic. 


Ensure accuracy of 
command or determine 
proper validation 
requirements via LIMITS 
command. 


Ensure accuracy of 
command or macro, or 
determine proper 
validation requirements 
via LIMITS command. 


Verify that user name 
and password are valid. 
If secondary USER 
commands are disabled, 
ensure that no secondary 
USER commands are 
present. 


ROUTINE 


PFM 


PFM 


RESEX 


RESEX 


PFM 


IMS - 


AMT - 


TAS. 
AMT 


ams 


CONTROL 


LEM 


DsD 
EXUBUT 
EXCSLV 
MSI 
QFSP 
RESEX 
1MA 
TAFEX 


CPM 
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MESSAGE 


USER ACCESS NOT VALID. 


USER ACCESS NOT VALID. 


USER CANNOT SWITCH FROM SECONDARY 
APPLICATION. 


USER NOT VALIDATED FOR SECONDARY 
APPLICATION. 


USER SECURITY COUNT EXHAUSTED. 


VEJ - BUFFER ARGUMENT ERROR. 


VEJ - INCORRECT REQUEST.: =~ 


VSN FILE ERROR. 


pfn WAITING ALTERNATE STORAGE EXEC. 


WAITING FOR MAGNET. 


WAITING FOR NFL. 


WAITING FOR PN=packname, type. 
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SIGNIFICANCE 


The SRU or time Limit request is outside of 
your validated range. 


One of the following: 

- You are not authorized to create 
direct access or indirect access 
files. 

- You are not authorized to access 
auxiliary devices. y 

- Your job made a CATLIST request for 
permit information on a file that 
has a higher access level than that 
of your job. 


You attempted to enter an APPSW command 
from a secondary application. 


You submitted an APPSW command specifying 
an application for which you are not 
validated. 


.The security count for the user name 


specified has been decremented to zero. 
You are denied all access to the operating 
system until the operator resets your 
security count. 


Dayfile message indicating that FET buffer 
pointers are incorrect. (FWA<LWA<FL) was 

not true or TID (terminal id) with complement 
address was not within the field Length. 


Dayfile message indicating that one of the 
following conditions has occurred: 

- VEJ was not called by a subsystem. 

- The FET address was out of range. 


Dayfile message indicating that a RESEX 
internal problem occurred (VSN file entry 
does not match job identification). 


The file must be staged from alternate 
storage to disk and the alternate storage 
executive is not currently available to 
perform the stage operation. 


The job is waiting for the magnetic tape 
subsystem to be activated, 


Informative message stating that your job 
has been delayed and/or rotled out 
waiting for NFL space. The job has not 
been aborted; it will eventually continue. 
The message is visible via ENQUIRE. 


The job is waiting for the operator to. 
mount pack packname on device type type.- 


ACTION 


Retry with a Lower value. 


Contact your site 
administration about 
obtaining the necessary 
validations. for 
CATLIST request, 
resubmit the request 
after raising your job's 
access level. 


To return to your 
primary application, Log 
out of your secondary 
application. If you 
wish to switch to a 
third application, you 
can enter another APPSW 
command from your 
primary application. 


To check your current 
validations, enter a 
LIMITS command. If you 
require validation for 
additional applications, 
see your site 
administration. 


Contact site personnel 
to reestablish access. 


Write a PSR and include 
support materials to 
allow CDC to duplicate 
the problem. 


Write a PSR and include 
support materials to 
allow CDC to duplicate 
the problem. 


Reenter the command or 
rerun the job. If the 
problem recurs, inform 
your site analyst or 
contact Central Software 
Support. 


Wait for executive to be 
started or inform site 
operator that the 
alternate storage 
executive should be 
ilitialized. 


Wait for the operator to 
activate MAGNET or 
terminate job. 


None. 


Wait until: the operator 
mounts the requested 
pack or terminate job. 


ROUTINE 


CONTROL 


PFM 


TLX 


TLX 


CPM 


VEJ 


asVEJ 


RESEX 


PFM 


RESEX 


PEM 


RESEX 
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MESSAGE 


WAITING FOR RESOURCE FILE. 


WAITING FOR RESOURCES. 


WAITING FOR VSN= vsn, type. - 


WAITING ~- INACCESSIBLE DEVICE 


WAITING ON TRACK LIMIT. 


WRITE-DOWN OF DATA PROHIBITED. 


_ WRITE-DOWN PROHIBITED ON FILE, filename 
AT address. 


WRITE ON READ-ONLY FILE filename AT address. 


WRITE OVER LABEL ILLEGAL. 


WRITE TAPE MARK ERROR 


WRITEDOWN PROHIBITED ON FILE FILENAME 
AT address. 


WRONG PARITY, filename AT address. 
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SIGNIFICANCE 


The job is waiting for the resource demand 
file or VSN file to become available. 


The job is waiting for sufficient resources 
to allow assignment of the tape/pack 
without causing a system deadlock. 


The job is waiting for the operator to 
mount the tape with VSN vsn on the 
specified type (MT, HD, PE, or GE). VSN= 
SCRATCH indicates that any scratch tape is 
acceptable. 


Your job has been rolled out waiting for an 
inaccessible mass storage device. The 
device is off, down, or is encountering 
hardware errors. 


The job is waiting for additional tracks on 
the familyname device containing ‘the 
resource demand and VSN files. 


One of the following: 

- On an APPEND or REPLACE command or 
macro, the access level of the local 
file is higher than the access level 
of the permanent file. 

- On a DEFINE command or macro, the 
access level of a local.file having 
the same name as the file specified 
has a lower access level than the 
job. 

= On a CHANGE, PERMIT, or SETPFAC 
command or macro, the access level 
of the specified permanent file is 
Lower than that of the job. 


The access level of your job is higher 
than the access level of file filename, 
and the file is a tape file or a direct 
access file. 


Either you attempted to write on a file 
with write lock-out, or the direct access 
file was not attached in write mode. 


You attempted to write over the VOL1 label. 


The tape subsystem was unable to write a 
tape mark on the tape being written, 
probably as a result of a bad tape. 


The access level of your job is higher than 
the access level of file filename, and the 
file is a tape file or a direct access 
permanent file. 


A seven-track tape is being read in 
opposite parity from which it was written. 


ACTION ROUTINE 


Wait until resource file 
becomes available or 


» RESEX 


. terminate job. To 


operator: If job is not 
rolled out and this 
message persists, inform 
site analyst or drop the 
job. If the operator 
decides to override an 
interrupted job at this 
point, the preview data 
in the demand file is 

not cleared and the E,P 
display continues to 
show the VSN request 
associated with the job 
until you log off or 
issue a subsequent 
request for tape or pack. 
Wait until the resources RESEX: 
become available or 
terminate job. 

Wait for the operator to RESEX 
mount the tape or 

terminate the job. 


Inform site analyst. 4RJ 


Wait for the additional 
tracks or terminate job. 


RESEX 


Retry using a higher PFM 
access level for the 

permanent file (APPEND 

or REPLACE), or change 

the job's access level 

and then retry (DEFINE, 

CHANGE, PERMIT, or — 

SETPFAC). 


None. You may. not . 4MS 
write on this file 

while your job is 

at the current 

access level. 


Reattach file in write IMS 
mode or clear write " IAFEX 
interlock. 


Have the operator blank 4MT 
label the tape. 


Replace tape and try 4MT 
again. If problem 

persists, try another 

tape drive. If problem 

still occurs, inform 

site analyst. 


None. You may not 4MS 
write on this file 

while your job is 

at the current 

access Level. 


Ensure accuracy of IMT 


format parameter.-(F) on 
command or macro. 
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MESSAGE : SIGNIFICANCE 


XD/XT EXCEEDS MAXIMUM. The XD parameter for a password or file 
: permission is more than the maximum number 
of days past the current date, or the XT 
parameter is larger than the maximum 
allowed. 


XL BUFFER/FET PARAMETER ERROR, filename : «+ One of the following: 
AT address. 5 - HDR1 Label in extended label buffer or 
: FET contains a nonnumeric display code 
value in a numeric field, 
- Character count in header word preceding 
labels in the extended label buffer does 
not equal 80. 


200 BPI WRITE INCORRECT. c The tape unit (667 or 677) cannot record 
data at 200 bpi. 
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ACTION 


‘Correct XD or XT 


parameter and retry. 


Correct condition that 
caused error and retry. 


Specify a different tape 
density. 


ROUTINE 
PFM 


AMT 


IMT 
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GLOSSARY |.  C 


Abort 


To terminate a program, job, or job step 
when an error condition (hardware or 
software) exists from which the program 
or. computer cannot recover. 


Absolute Assembly 


In the context of this manual, a COMPASS 
program assembled with the ABS pseudo 
instruction in which there are no 
references to external entry points. 
Compare with Relocatable Assembly. 


Access Category 


Refer to File Access Category, Job 
Access Category Set, and System Access 
Category Set. ; 


Access Level 


A property of each file, job, and 
equipment on a secured system that is 
used to indicate the sensitivity of 
information in the file or job, or the 
sensitivity of information that can be 
processed by the equipment. Ona 
secured system, there are up to eight 
access levels corresponding to 
increasing levels of sensitivity, and 
each user is authorized to access some 
or all of those levels. Refer also to 
Equipment Access Levels, File Access 
Level, Job Access Level, and System 
Access Levels. 


Access Level Limits 
Refer to Job Access Level Limits. 
Account Block 
A string of commands between two CHARGE 
commands or between a CHARGE command and 
end-of- job. 
Allocatable Device 
A storage device allocated by the system 
without operator intervention that can 


be shared by more than one job. - 
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Alphanumeric 


Consisting of alphabetic and/or numeric 
characters only. 


Alternate User Name 


A user name specified in a permanent 
file request which indicates the action 
is to be taken.on an alternate user’s 
permanent file. 


ANST 


American National Standards. Institute. 
An organization that establishes 
standards for the benefit of its member 
organizations. 


ASCIL 


American National Standard Code for 
Information Interchange... The standard 
character set and code used for 
information interchange between systems. 


Auto Recall 


The act of a program releasing control 
of the CPU until a requested function is 
complete. Refer to Recall. 


Auxiliary Device 


Mass storage device that is not part of 
a permanent file family. Auxiliary 
devices can contain direct or indirect’ 
access permanent files. 


Block 


A grouping of user records created for 
efficiency in transfer between memory 
and storage devices. . For magnetic. 
tapes, it is the information between 
interrecord gaps. Block size is 
specified with the LABEL macro for L 
format tapes. 


BOT 


Refer to Beginning-of-Information. © 


Buffer 


An intermediate storage area used to 
compensate for a difference in rates of 
data flow, or times of event occurrence, 
when transmitting data between central 
memory and an external device during 
input/output operations. 


Byte 


A group of 12 bits. Five bytes comprise 
a 60-bit central memory word. Bytes are 
numbered O through 4 from the left. 


Central Memory (CM) 


The main storage device whose storage 
cells (words) can be addressed by a 
computer program and from which 
instructions and data can be loaded 
directly into registers from which the 
instructions can be executed or from 
which data can be manipulated. 


Central Processor Unit (CPU) 


The high-speed arithmetic unit that 
performs the addition, subtraction, 
multiplication, division, incrementing, 
logical operations, and branching 
instructions needed to execute programs. 


Checkpoint 


The process of writing to a magnetic 
tape or mass storage file a copy of your 
job's central memory, the system 
information used for job control, and 
the names and contents of all assigned 


files that are identified in a.CHECKPT 
request. 


Checkpoint File 


File on which the results of a partially 
completed job are dumped when a 
checkpoint request is processed. 


Checksum 


A numeric value used to verify a file. 


“Circular Buffer 


A temporary central memory storage area 
that contains data during input/output 
operations. Routines that process I/0 
treat the first word of the buffer area 
as contiguous to the last word of the 
buffer area. 


Coded Mode 


Refers to the setting of the coded mode 
bit in the FET of the READCW/WRITECW 
header word. The setting of this bit is 
used to interpret data as binary or 
coded. Coded data goes through code 
conversion to/from a different character 
set (BCD on 7-track, ASCII or EBCDIC on 
9-track). 


Command Record 


The first, and possibly only, record of 
a job file consisting of command images 
that start with the Job command and end 

.with the first EOR, EOF, or EOI. Also 
refers to a procedure containing 
commands. 


Common Deck 


A subprogram or group of macro or symbol 
definitions that are accessed from a 
program library using the Modify CALL 
directive or COMPASS XTEXT 
pseudoinstruction. 


Compare/Move Unit (CMU) 


The hardware that executes the CPU 
instructions for moving and comparing 
data fields consisting of strings of 
6-bit characters. 


COMPASS 


The standard assembly language used with 
CYBER 170, CYBER 70, and 6000 Computer 
Systems. Also, the command used to 
assemble a program written in the 
COMPASS assembly language. 


Control Byte 
A 12-bit code that changes the current 


input or output mode at an interactive 
terminal. : 
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Control Point 


The portion of central memory that is 
assigned to a job. When a job is 
allocated a portion of central memory, it 
becomes eligible for assignment to the 


central processor for execution. 


Conversion Mode 


Refers to the CV parameter in the LABEL 
command. The conversion mode specifies 
the character set used to convert coded 
data and labels. 


CPU. 


Refer to Central Processor Unit. 


CYBER Loader 


The utility that prepares programs for 
execution by placing program instruction 
and data blocks in central memory. 


CYBER Record Manager (CRM) 


DAS 


A software product that allows a variety 
of record types, blocking types, and file 
organizations to be created and accessed. 
Products like COBOL 5, FORTRAN Extended 
4, FORTRAN 5, Sort/Merge 4, Sort/Merge 5, 
ALGOL 5, and DMS 170 use CRM to manage 
execution time input/output. Neither the 
input/output of the operating system nor 
that of most of the system utilities such 
as COPY or SKIPF is implemented through 
CYBER Record Manager. All CYBER Record 
Manager file processing requests 
ultimately pass through the operating 
system input/output routines. 


Refer to Disk Array Subsystem. 


Dayfile 


A chronological file created during job 
execution which forms a permanent 
accounting and job history record. 
Dayfile messages are generated by 
operator action or when commands are 
processed. A copy of the dayfile is 
printed with the output for each job. You 
must explicitly request it in an 
interactive job. 
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Default 


A system-supplied option used when you do 
not supply the option. 


Device Type Code 


The 12-bit display code of the type of 
device upon which a file resides. 


Direct Access File 


A NOS permanent mass storage file that 
can be attached to the your job. Ali 
changes to this file are made on the file 
itself rather than a temporary copy of 
the file (compare with Indirect Access 
File). 


Disk Array Subsystem 


A disk storage subsystem. The 5830 Disk 
Array Subsystem allows the configuration 
of multiple disks combined into a single 
logical device. A combination of 5832 
Solid State Disk (SSD) units and 5833 
SABRE units can be configured in a single 


‘ cabinet. 


The 5832 SSD can be configured either as 
a single unit or as two units driven in 
parallel (thus increasing both the size 
and speed of the device) . 


The 5833 SABRE can be configured in four 
ways: 


- As a single unit; 

- As a single unit with a second unit 
used for parity; 

- As two units driven in parallel; 

- As two units driven in parallel with 
a third unit used for parity. 


When a device is configured with a parity 
unit, the data written to the device is 
redundantly recorded. In the event of a 
failure of any single unit on such a 
device, the system can continue to access 
all the data on the device. Once the 
failing unit is repaired or replaced, the 
system automatically restores the data on 
that unit, still allowing access to the 
device during the restoration process. 


Display Code 


A 6-bit character code set used to 
represent alphanumeric and special 
characters. 
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Disposition Code 


A two-character mnemonic indicating 
destination queue and format for 
processing a file named on a ROUTE 
function. 


ECS 


Extended Core Storage. Refer to Extended 
Memory. 


Empty PRU/Record 


A PRU that contains no user data. Refer 
also to Zero Length PRU. 


End-of-File (EOF) 


A boundary within a sequential file, but 
not necessarily the end of a file that 
can be referenced by name. The actual 
end of a named file is defined by EOI. 
For labeled tape, EOF and EOI (denoted by 
the EOF1 label) are the same. For 
multifile tape files, EOF and EOI do not 
correspond. In the product set manuals, 
an end-of-file is also referred to as an 
end-of-partition. 


End-of-Information (EOT) 


The end of data on a file. Information 
appearing after this point igs not 
considered part of file data. In card 
decks, a card with a 6/7/8/9 multiple 
punch in column 1. On mass storage 
devices, the position of the last written 
data. On labeled tape, it is the EOF1 
label. CYBER Record Manager defines end- 
of-information in terms of file residency 
and organization. 


End-of-Line (EOL) 


A separator in coded files that is 
represented by 12 bits of zero, right- 
justified in a 60-bit word. In some 
cases, up to 66 bits of trailing zero 
bits are considered an end-of-line. 


End-of-Record (EOR) 


The terminator of a logical record. Ona 
PRU device, a short PRU or a zero length 
PRU with a level designator of 0 
indicates EOR. On tapes that are not PRU 
devices, an interrecord gap indicates 
EOR. 


Ics 


End-of-Tape (EOT) 
A reflective strip near the end of a 
Magnetic tape. It is used to signal 
termination of operations on a particular 
tape volume. At least 5.5 metres (18 
feet) of tape must follow this marker. 

Entry Point 
A location within a program or procedure 
that can be referenced from other 
programs. Each entry point has a unique 
name with which it is associated. Refer 
to External Reference. 

EOF 
Refer to End-of-File. 

EOI 
Refer to End-of-Information. 

EOL 
Refer to End-of-Line. 


EOR 


Refer to Endg-of-Record. 


BOT 


Refer to End-of-Tape. 


Equipment Access Levels 


A range of access levels specified for 
each equipment on a secured system. In 
order for a file to be stored or output 
on a given equipment, the file’s access 
level must be within the equipment access 
levels for that equipment. 


Equipment Code 


Refer to Device Type Code. 


Equipment Status Table (EST) 


‘A list of all peripheral devices 
connected to the system. Each table 
entry indicates the status of a 
particular device. 
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EST Ordinal 


The number designating the position of an 
entry within the equipment status table 
(EST) established at each installation. 
Devices are identified in operator 
commands by EST ordinals. 


Exchange Jump 


Execution of a CPU program is initiated 
by an exchange jump. The program is 
defined by the contents of the exchange 

_ package area before the exchange jump 
took place. For the program to execute, 
the proper contents of its operational 
registers must be loaded into the CPU. 
These register contents are what is 
contained in the exchange package area 
associated with the program. 
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'. Exchange Package 


~A 20g-word table containing .information 
used in exchange jumps during job 
execution: contents of central. processor 
registers, RA and FL in central memory 
and in extended memory, and the program 
address. The-table is stored in the 


job’s field length and can be printed as | 


‘.part of the output of a central memory 
dump. : 


Exit Mode 


A group of flags that specify the-types 
of errors that can cause the CPU ‘to 
abort. | 43 


Extended Core Storage (ECS) 


A type of extended memory -that is ‘an 
option available for 6000 Computer 
Systems, CYBER’ 70 Computer Systems, 
CYBER 170 Computer Systems (except for 
models 176), and CYBER 180-class 
machines. Refer to Extended Memory... 


Extended Labeled Processing 


A tape processing mode in which all tape 


labels (including optional labels) are 
read into a label buffer for. further 
processing. . Pog 


Extended Memory 


An additional portion of memory 
available as an option. This memory. can 
be used for program and data storage, 
but not for program execution. Special 
hardware instructions exist for 
transferring data between central memory 
and extended memory. Extended memory. 
consists of: either extended core storage 
‘(ECS), large-core memory extended 
(LCME), extended semiconductor. memory 
(ESM), or unified extended memory (UEM). 


Extended Semiconductor Memory (ESM) 


A type of extended memory that is an 
option available for 6000 Computer 
Systems, CYBER 70 Computer Systems, 
CYBER 170 Computer Systems (except for 
models 176), and CYBER 180-class 
machines. Refer to Extended Memory. 
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External Reference 

A reference in a program to an entry 
point in-another program. Throughout 
athe loading process, externals are 
matched to entry -point (this is also 
referred to as satisfying externals); 
that is, addresses referencing externals 

‘are supplied with the correct address. 


Family Device 


Mass storage permanent file device 
associated with a specific system. A 
family may consist of from 1] through 63 
" logical devices. Normally, a system 
runs with one family of permanent file 
devices available. However, additional 
families may be introduced during normal 
operation. This enables users 
associated with the additional families 
to access their permanent files via the 
alternate family. [ 


Fast ee Loader (FDL) 


A facility that provides fast loading 
and unloading of specially formatted 
code called capsules. The amount of 
memory required for job execution can be 
greatly reduced because capsules can be 
easily loaded and unloaded as needed, 
freeing memory for other uses. 


var) 


FET 
Refer to File Environment Table. 
Field Length 


The area-in central memory allocated to 
a particular job; the only part of 
central memory that a job can directly 
access. Also the number of central 
memory words required to process a job. 


. Field Tengen Extended (FLE) 


Amount..of extended memory. spearenee. ‘to an 
executing job. 


File 


1. A set of information that begins at 
beginning~of-information (BOI), ends 
at end-of~information (EOI), and is 
referenced by a local file name. 


2. That portion of a,multifile. file 
terminated by an end-of-file (EOF). 


3. Data recorded on a magnetic tape 
beginning after an HDRI label and 
ending before an EOF! label. 


NOS commands requiring a parameter that 
is a file name refer to definition l. 
Commands requiring a parameter that 
specifies the number of files refer to 
definition 2. Definition 3 applies only 
to labeled magnetic tapes. 


File Access Category 


A property of a permanent file used by 
the. creator of the file on a secured 
system to restrict access of the file to 
a particular group of users. A secured 
system supports up to 32 access 
categories, and each user is authorized 
to use some, all, or none of those 
categories. Refer also to Job Access 
Category Set and System Access Category’ 
Set. . : : 


File Access Level - . 


A property of each file on a secured 
system used to indicate the sensitivity 
of information contained on the file. A 
file is assigned the current job access 
level by default when it is created or 
stored; the file creator may specify any 
access level for that file that is 
within the set of access levels valid 
for the job, the system, the file 
creator, and (for interactive jobs) the 
communication line to the host 
mainframe. Any user who accesses a file 
on a secured system must be validated 
for the access level of the file. Refer 
also to Access Level, Job Access Level, 
and Job Access Level Limits. 


File Environment Table (FET) 


A table within a progam's field length 
that defines the current status and 
properties of a file being used by the 
program. The program communicates with 
operating system input/output routines 
through the FET. One FET exists for each 
file in use by the program. 


File Flushing 


The process of writing the contents of a 
file's circular buffer to mass storage 
when certain conditions are met. 


File Name Table (FNT ) 


A system-managed table that contains job 
control information for all active files 
in the system. Files that are local to 
a job have an entry in the job's local 
file name table (refer to Local File 
Name Table); system files have an entry 
in the system file name table (refer to 
System File Name Table). Each file name 
table entry consists of a file name 
table word, a file status table word, 
and, for local files, a file utility 
table word. 


File Name Table (FNT) Word 


The first word of every file name table 
entry. This word contains the local 
file name, file type, and other job 
control information. 


File Set 


One or more tape files referred to by 
the set identifier on a tape assignment 
command or macro. A file set may 
consist of: 


1. One file recorded on a single volume. 


2. More than one file recorded on a 
single: volume. 


3. One file recorded on more than one 
volume. 


4. More than one file recorded on more 
than one volume. 


' All files within a file set have the 
same set identifier in their HDR1 labels. 


File Status Table (FST) Word 


The second word of every file name table 
entry. This word contains information 
pertaining to the file's location on 
mass storage and other job control 
information. 
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File Utility Table (FUT) Word 
‘The third word of every file name table 
entry. This word contains the 12-bit 
_installation area for the file; the 
remainder of the word is reserved for 
future use. 

FL , > 
-Refer to Field Length. 


Flag 


A character or bit that signals the 
occurrence or presence of a particular ; 
condition. : 


FLE 
Refer to Field Length Extended. 
FNT 


Refer to Local File Name Table. 


FNT Word 


Refer to File Name Table Word. 
Foreign Tape 


NOS classifies all non-CDC standard 
tapes into either of two tape groups, 
foreign or stranger. The foreign tapes 
are defined by the F data format, which 
has an unknown maximum block size. . 
Contrast with Stranger Tape.: 


Frame 


A tape recording unit made up.of 1 bit 
from each tape track (7 bits for 7-track 
tape and 9 bits for 9-track tape). Each 
frame on a coded tape usually represents 
one character. 


FST Word 


Refer to File Status Table Word. 
Full Track (FT) 


Reading/writing sequential sectors on a 
rotating mass storage device. 
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‘Half Track (HT) 


Function Processor 


A system CPU or PP program that the user 
can call by placing a request-in 
location RA+l.° Function processors 
perform input/output, local and - 
permanent file manipulations, and so on. 


Generation 


The position of a file within a series 
of files, each file developed from the 
preceding file. The generation number 
and generation version number of a tape 
file can be entered in its HDR1 label. 


Global Library Set 


An ordered set of libraries used for 
program loads and for satisfying 
externals; these libraries remain in’ 


effect throughout job execution unless 
aperte ically changed. 


t 


Reading /writing alternate sectors on an 
844 or 885 disk pack. 


Indirect Access File 


A NOS permanent file that is accessed by 

making a temporary copy of the file (GET 

macro). It is created or altered by 

saving or replacing the contents of an 

existing working file (REPLACE or SAVE | 
macro). 


Input .File Type 


Job file. Its first record is a control 
statement record, which may be followed 

by records containing data, directives, 

-or programs used by job steps. 


Interactive Programs 


CPU programs in which the user and the 
computer communicate with each other. 


Interrecord Gap 


-Space skipped between the writing of 
data blocks on magnetic tape. 


Interrupt 


Job 


Job 


Job 


Job 


To stop a running program in such a way 
that it can be resumed at a later time. 
Also a special control signal which, 
when issued, causes action as described 
by the program. 


Access Category Set 


On a secured system, a set of access 
categories is set when the job is 
initiated. This set is the intersection 
of the user's set of validated access 
categories and the system access 
category set. Refer also to File Access 
Category and System Access Category Set. 


Access Level 


On a secured system, each job has an 
access level. This is the default 
access level that is assigned to files 
that are created or stored in the job. 

A job's initial access level is the 
lower access level limit for the job. 
The job's access level is automatically 
raised to the access level of any file 
from which information is read. The job 
access level can also be changed by the 


user. Refer also to Job Access Level 
Limits. 


Access Level Limits 


An upper -limit and a lower limit that 
determine the range of access levels 
that are valid for a particular job on a 
secured system. All files used in a 
given job must have an access level 
within the job's access level limits. 


Step 


An individual command, procedure or 
loader sequence. A group of job steps 
forms a job stream, command record, or 
procedure file. 


Label 
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A block at the beginning or end of a 
magnetic tape volume or file, which 
serves to identify and/or delimit that 
volume or file. 


Large Central Memory. Extended (LCME) 


A type of extended memory that is an 
option available for model 176. Refer to 
Extended Memory. : 


LCME 

Refer to Large Central Memory Extended. 
Level Designator 

Refer to Level Number. 
Level Number ve 


The level number ts an octal number in 
the terminating marker of a PRU, ranging 
from 00 to 17 (octal). A level 17 in an 
empty PRU designates an EOF. A level'0 
in a short PRU designates an EOR. A 
level designator of 1 is used as a flag 
to indicate that a short PRU of data is 
actually a line of input data from a 
terminal. The level designator is 
returned to the FET for some read: ++ 
functions and to the trailing control 
word for a READCW function. 


1lfn 


Refer -to Local File Name. 


Library 


A file or collection of files containing 
executable programs and tables needed to 
locate and load the programs. A system 
library can contain peripheral processor 
programs in addition to the central 
processor programs. A user library is 
file formatted as a library but is not 
available to a job until it has been 
explicitly declared via CYBER Loader 
commands or macros. 


Library File 


Either a read-only file that can be 


accessed by several users simultaneously - 


or a file you specify on a LIBRARY 
command. : 


Line 


Refer to Zero-Byte Terminator and 
End~of-Line. 
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List of Files 


A table containing names of files that 
‘are to be considered for file flushing. 


Load Point 


Metallic strip marking the beginning of . 


the recordable portion of a magnetic. - 

, tape. Data, including labels, is 
written after the load point. . A rewind 
positions a single file volume to the 
load point. be 


Local File 


Any file that is currently- associated 
with a job. . Local files include all 
temporary files and attached direct 
access files. , 


“Local File Name 


The file name assigned to a file while 
it is local (assigned) to a job. The 


name is contained in the local file name 
table.: - 


Local File Name Table (FNT) 
2 ar ; , 
.A‘system-managed table that contains the 
local file name, the file type, and 
other job control information. 
Locked File 
A file on which you cannot write. 
Logical Identifier (LID) 
A three-character alphanumeric string 
used to identify a particular mainframe 
in a loosely coupled network. LIDs are 
identified by your site. 
Logical Record 
A data grouping that consists of zero or 


more PRUs and ends with a short PRU ora 
zero-length PRU. 


Macro 


A sequence of source statements that are. 


saved and then’ assembled. whenever needed 
through a macro call. - . 


ry 
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MLRS 


Maximum logical record size. “A number 
that specifies the maximum size for a 
hosteat record for S and L tape formats. 


Multifile. File 


A file seaeuintee more than one logical 
file. It begins at BOI and ends at 
EOI. On a labeled tape, a multifile. 
‘file is delimited by ROE COANE HDR1 
and EOF] labels. *° 


Multifile Set 


.,A tape file set having more than one 
tape file. < 


Network 


A data and message switching and routing 
system used to provide-communication 
between terminals, applications, and 
mainframes. 


Network Terminal 


A terminal that communicates with the 
operating system through the network. 


Nonallocatable Device 


A device (such as a magnetic tape unit, 
card reader, card punch, or line 
printer) which can be used onty, by one 
job at a time. 


Nonstandard Tape Label : ‘ 


A.tape label format for a tape.whose 
data cannot be processed by the system 
because the label is not one of the 
supported: label types. If the tape is at 
load point, a subsequent read operation 
skips to the first tape mark. 


Old Program Library (OPL) 
A Modify—formatted program library that 


contains source code EOE system routines 
and common decks. 
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opdef 


A sequence of source statements that are 
saved and then assembled whenever needed 
through an opdef call. Differs from a 
macro in that the assembler interprets 
the call by examining the format or. 


syntax of the instruction rather than the 


contents of the operation field alone.. 
OPL 

Refer to: Old Program Library. 
Overlay: 


One or more relocatable. program modules 
that have been relocated and: linked into 
a single absolute program. It can be a 
main, primary, or secondary overlay. 


Pack. Name 


A one- through seven~character name that 
identifies. the auxiliary device to be 
accessed in a permanent file request. 


Parameter 


A variable that is given a specific 
value for a particular purpose or. 
process. 


Parity 


In writing data, an extra bit is either 
set or cleared in each byte so that 
every byte has either an odd number of 
set bits (odd parity) or an even number 
of set bits (even parity). Parity is 
checked on a read for error detection 
and possible recovery. 


Password 


1. A system access word that must be 
used in addition to the user name at 
login. 


2. <A file access word that controls 
access to a particular file by 
alternate users. 


Peripheral Processor (PP) 
The hardware unit within the host 
computer that performs physical input 


and output through the computer’s data 
channels. 
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Permanent File 


A mass storage file that is cataloged by 
the system so that its. location and 
identification are always known to the 
system. Permanent files cannot. be 
destroyed accidentally during normal 
system operation. They are protected by 
the system from unauthorized access 
according to privacy controls specified 
when they are created. 


Permanent File. Catalog (PFC) 


A 16-word. entry that the system 
maintains: and uses. to, determine 
attributes of a. permanent file. 


Permanent File Family 


Permanent files which reside on the 
family devices of a specific system. 


Physical. Record 


On magnetic tape, information between 
interrecord gaps (refer to Block). It 
need not contain a fixed amount of 
data. For mass storage, refer to 
Physical Record Unit. 


Physical Record Unit (PRU) 


The amount. of information transmitted by 
a single physical operation of a 
specified device. For mass storage 
files, a PRU is 64 central memory words 
(640: characters); for magnetic tape 
files, the size of the PRU depends. upon 
the tape format. A PRU that is not full 
of user data is called a short PRU; a 
PRU that has a level terminator but no 
user data is called a zero-length PRU. 


PP 


Refer to Peripheral Processor. 


Preserved File 


A mass storage file that is recovered on 
all levels of system deadstart. These 
include permanent files, queued files, 
and system dayfiles. 
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Primary File 


A temporary file created with either the 
OLD, NEW, LIB, or PRIMARY command or the 
PRIMARY macro for most systems. The 
primary file is assumed to be the file on 
which most operations are performed 
unless another file is specified. There 
can be only one primary file associated 
with a job. The primary file is rewound 
before each job step given. 


Print File 


_An output file containing data to be 
printed at a central site or remote batch 
line printer. 


Private Auxiliary Device 


Auxiliary device associated with a 
specific user name. Only that user name 
may create files on the device, although 
other users may be permitted to access 
files which reside on the device. 


Program Library 


The file generated by Modify that 
contains the decks of line images. Line 
images in the program library are ina 
format that can be manipulated by Modify. 


PRU 
Refer to Physical Record Unit. 
PRU Device 


A magnetic tape file or a mass storage 
device. Records on these devices are 
written in physical record units (PRUs). 


Pseudoinstruction 


An assembler-defined instruction 
appearing in the operation field of a 
statement. It normally does not specify 
the assembly of a single machine 
instruction, but instead specifies some 
other assembly process (such as symbol 
definition or listing control) . 


Public Auxiliary Device 


Auxiliary device available for access by 
all validated users knowing the correct 
pack name. Additional validation is 
required to create or replace ae on an 
auxiliary device. 
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Punch File 


Output file containing data to be punched 
on cards. 


QFT 


Refer to Queued: File Table. 


Qualified Symbol 


A symbol defined when a qualifier is in 
effect during assembly. Through 
qualification, the same symbol can be 
referred to in different subprograms 
without conflict. 


Queued File Table (QFT) 


A central memory resident table 
containing a fourword entry for all 
active input and output queue files. 


Random Access 


Access method by which any record ina 
file can be accessed at any time. 
Applies only to mass storage files with 
an organization other than sequential. 
Compare with Sequential Access. 


Random Address 


The random address of a sector in a file 
is the number of sectors from the 
beginning of the file to that sector. 


Random File 


A file with an index entry to each record 
in the file. A file on a rotating mass 
storage device is a random file only when 
the random bit is set in the file 
environment table. The last record of 
the file is an index. 


Recall 


The state of a program when it has 
released control of the central processor 
until a fixed time has elapsed (periodic 
recall) or until a requested function is 
completed (auto recall). Recall is a 
system action request as well as an 
' optional parameter of some file action 
requests. 
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Record 
Refer to Logical Record. 
Record Separator 


In NOS, another name for an end-of-record 
{EOR) . 


Reel 
Refer to Volume. 
Reference Address (RA and RAE) 


RA is the absolute central memory address 
that is the starting or zero relative 
address assigned to a program. Addresses 
within the program are relative to RA. 
RA+1 is used as the communication word 
between the user program and the system. 
RAE is the absolute extended memory 
starting address assigned to a program. 


Register 


A register is a storage device used to 
hold binary data. There are 24 hardware 
registers (eight A registers, eight B 
registers, and eight X registers) in the 
CPU that can be directly controlled by a 
COMPASS program. The A registers contain 
addresses of words in central memory, the 
B registers are used for incrementing and 
indexing, and the X registers contain 
operands used in calculations and the 
results of these calculations. Other 
hardware registers contain information 
that is used by the operating system or 
by system hardware. 


Relative Address 


All addresses in a relocatable program 
are relative to a base address of zero. 
When a relocatable program is loaded for 
execution, the zero base address is 
assigned to a reference address. At that 
time, all addresses in the program become 
relative to the reference address. 


Relocatable Assembly 
An assembled program that contains 


references to external entry points. 
Compare with Absolute Assembly. 
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Removable Device 


A rotating mass storage device that the 
system can make unavailable. It is not 
necessary that the device be physically 
detachable from the rotating mass storage 
drive. 


Rollout 


The removal of jobs from central memory 
to mass storage before execution is 
complete, so the control point and 
central memory can be assigned to another 
job. A job is rolled out when it is 
waiting for an external event, when its 
control point and/or central memory is 
needed by a higher priority job, or when 
it exceeds its central memory time slice. 


Rollout File 


A file containing a job (and system 
information) that has been temporarily 
removed from the main processing area of 
the system. 


Rotating Mass Storage (RMS) 


A disk storage device. 


SABRE 


The 5833 SABRE is a disk unit that may be 
configured as part of the 5830 Disk Array 
Subsystem (DAS). It has a formatted 
capacity of 1039 megabytes. 


Sector 


Refer to Physical Record Unit. 


Secured System 


A system in which a mandatory security 
mechanism has been enabled during 
deadstart. A secured system protects 
information by enforcing restrictions 
based on access levels and access 
categories, and restricts many sensitive 
system functions to security 
administrators. 
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Security Administrator 


A secured system prevents users and 
operators from performing certain 
functions that could result in the 
unauthorized disclosure of information. 
These functions can only be performed by 
a person who is designated a security 
administrator. A security administrator 
is always authorized to access the 
highest level of information stored on 
the system. This person performs 
functions in the areas of installation, 
user validation, system operation, and 
system maintenance. 


Security Count 


The number of security violations you 
have left before you are denied access to 
the system. 


Security Unlock Status 


This status of the system console applies 
only to a secured system and must be set 
by a security adminstrator. The console 
must be in security unlock status in 
order for the security administrator to 
perform certain functions that are 
restricted on a secured system. 


Sense Switches 


Six 1-bit flags located in the user’s 
control point area and in bits 11 through 
6 of RA+0 of the job field length. These 
bits can be used-to communicate with 
system routines (refer to the ONSW and 
OFFSW macros in section 6). 


Sequential Access 


A method in which only the record located 
at the current file position can be 
‘accessed. Refer to Random Access. 


Sequential (SQ) File 
A file in which records are accessed in 
the order in which they occur. Any file 


can be accessed sequentially. 


Short PRU 
A PRU that does not contain the maximum 


amount of character data allowed for a 
PRU. Refer to Zero-Length PRU. 
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Solid State Disk 


The 5832 Solid State Disk is a disk unit 
that may be configured as part of the 
5830 Disk Array Subsystem (DAS). It has 
a formatted capacity of 165 megabytes. 


Special Entry Point 


An entry point that enables system 
programs to perform special functions. 


SRU : 


Refer to System Resource Unit. 


SSD 


Refer to Solid State Disk. 


Standard Labeled Tape 


A tape with labels conforming to American 
National Standard Magnetic Tape Labels 
for Information Interchange X3.27-1969. 
Also called a system labeled tape. 
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Stranger Tape 


NOS classifies all non-Control Data 
standard tapes into either of two tape 
groups, foreign or stranger. The 
stranger tapes are defined by the S data 
format, which has a maximum block size of 
1000g CM words. Contrast with Foreign 
Tape. 


Symbol 


A set of characters that identifies a 
value and its associated attributes. 


System Access Category Set 


On a secured system, a set of access 
categories are set during level 0 
deadstart. This set may consist of some, 
all, or none of the 32 possible access 
categories. While the system is running, 
users may only use access categories that 
are within the set of system access 
categories. Refer also to File Access 
Category and Job Access Category Set. 
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System Access Levels 


On a secured system, a range of access 
levels is set during level 0 deadstart. 
This range may contain some or all of the 
eight possible access levels. While the 
system is running, users may only use 
access levels that are within the range 
of system access levels. 


System File 


A file that can be accessed only by a 
system program. 


System File Name Table 


A system-managed table that contains a 
file name table entry for the various 
system files. 


System Labeled Tape 
Refer to Standard Labeled Tape. 
System Library (SYSLIB) 


The collection of tables and object 
language programs that reside in central 
memory or on mass storage and are 
necessary for running the operating 
system and its product set. 


System Request 


A request placed in location RAt1 for a 
function processor to perform a special 
process. 


System Resource Unit (SRU) 


A unit of measurement of system usage. 
The number of SRUs includes the central 
processor time, memory usage, and 
input/output resources used for a given 
job. 


System Text 
A set of tables containing symbol, micro, 
macro, and opdef definitions that can be 
saved on a file to be accessed by other 
programs. 


Tape Format 


A parameter that specifies the internal 
recording format of a magnetic tape. 
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Tape Mark 


A delimiter written on tapes under 
operating system control to separate 
label groups, files, and/or labels. 
Interpretation depends on the tape 
format. 


Temporary File 


A file that is currently associated with 
a job and is not a permanent file. 
Temporary files cease to exist when they 
are returned to the system (either by 
means of a command or macro or upon job 
termination). 


Time Slice 


The amount of CPU or CM time a job is 
allowed to use before the system lowers 
its priority to allow other jobs to 
execute. 


Timed/Event Rollout 


A condition in which an executing job has 
been temporarily removed from central 
memory but will be rolled back into 
central memory when a specified event 
(such as a file is no longer busy) or a 
specified time period has elapsed. 


Refer to Unified Extended Memory. 


Unified Extended Memory 


A type of extended memory that is 
available as an option for CYBER 180- 
class machines and models 865 and 875. 
UEM differs from other types of extended 
memory in that it is a portion of central 
memory and not a separate memory unit. 
Refer to Extended Memory. 


Unlabeled Tape 


A magnetic tape that does not have a 
header label. Unlabeled tapes generated 
by the operating system contain a trailer 
label similar to the trailer for a 
standard labeled tape. 
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Unsecured System 


A system in which the security mechanism 
has:not been enabled during deadstart. 
The restrictions based on access levels 
and access categories are not enforced 
on an unsecured system. 


User Index 


A unique 17-bit identifier that is 
associated with each user name. The 
user index is used by the permanent file 
manager to identify the device and 
catalog track for the users permanent 
files. 


Validation File 


File containing validation information 
for all users (user names, passwords, 
resources allowed, and so on). 


Volume 


A reel of magnetic tape. A given file 
can be composed of more than one volume. 


Volume Serial Number (VSN) 


A one- through six-character identifier 
that identifies the volume of magnetic 
tape to thé system. 


VSN 
Refer to Volume Serial Number. 
Word 


A group of bits that occupy a single 
memory cell. A central memory or 
extended memory word is 60 bits in 
length. The bits are numbered 59 
through 0 starting from the left. A 
word is also composed of five 12-bit 
bytes, numbered 0 through 4 from the 
left. 
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Write Ring 


A circular device inserted into a tape 
reel indicating to the tape unit that it 
_ can write on that reel. NOS checks for 
‘the presence of a write ring if you 
request it. 


Zero-Byte Terminator 


-.The 12 bits of zero.in the low order 
‘position of a central memory word that 
are used to terminate a line of coded 
information. A record with such a 
terminator in CYBER Record Manager is a 
zero-byte record (Z type record). 


Files created interactively at a 
terminal and by commands that manipulate 
coded lines contain zero-byte terminated 
records. The image of cards ‘input 
‘through a card reader. also has such a 
terminator. 


In 6-bit display: code, two colons create 
‘12 bits of zeros in the 64-character 


set. If two consecutive colons occur in 


a file that contains zero-byte 
terminated records, they might be stored 
in the lower order portion of a word and 
create a zero-byte terminator. 


C10-coded 1/0 operations, system 
commands, and dayfile processing macros 
use files whose lines are terminated by 
a zero byte. 


Zero-Length PRU 


A PRU that contains system information, 
but no user data. Under NOS, a 
zero-length PRU defines EOF. 


INTERPRETIVE MODE READING AND WRITING D 
OF EXTENDED MEMORY 


Interpretive mode processing of extended memory read and write operations gives the COMPASS 
programmer an effective means of breaking up large block extended memory transfers and 
processing recoverable extended memory errors. The efficiency of long extended memory 
transfers tends to be degraded because. of PP-initiated exchange jumps which force extended 
memory transfers to be completely restarted. Interpretive mode processing breaks up large 


. blocks into smaller, 400g-word blocks, thereby minimizing the effects of these exchanges. 


Extended memory transfer errors are retried asa block transfer. and then as single word 
transfers if necessary. If the error is recovered, it is logged in ‘the system error log and 
is transparent to the user program. Unrecoverable errors are also logged and must be 
processed by the user program. 


The interpretive routines are available on common deck COMCECS for absolute COMPASS programs 
and as relocatable routines in SYSLIB for relocatable COMPASS programs. Additionally, 
common deck COMCECM is provided:to redefine the RE and WE COMPASS instructions. COMCECM is 
also. available on systems text ECSTEXT. Thus, for absolute COMPASS programs, the user must 
either make specific calls to. both common decks or call COMCECS and specify S=ECSTEXT on the 
COMPASS command (refer to the COMPASS Reference Manual). For relocatable COMPASS POG ems: 
you need only epeetey ECSTEXT as.an’alternate systems text on the COMPASS command. 


Programs using eenprepive mode reading and writing of extended memory do so with the usual 
RE and WE COMPASS instructions. If, while in interpretive mode, you desire to perform 
noninterpretive reading and writing of extended memory, the RD and WT instructions must be 
used.» These instructions are defined on common deck COMCECM. These instructions read and 
write extended memory directly while in interpretive mode, as in the normal execution of the 
RE and WE instructions. 
The instructions defined in ECSTEXT and common deck COMCECM are in the following formats. 

inst Bj 

inst K 

inst BI+tK 


Instruction inst is one of the following. 


inst Description 

RE - Read extended memory in interpretive mode 

WE Write extended memory in interpretive mode 

RD Read ee enaed memory noninterpretively in ineerprecive mode 
WI Write extended memory noninterpretively in interpretive mode 
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SPECIAL USER INFORMATION | | E 


Se A I IY FT A I RS PIS EONS 


This appendix provides special information available to the applications programmer. The 
' following topics are described. ; 


e Job communication area e EJT status and connection status codes 
e Exchange package area e Service class types 
e File types and job origin codes e . EJT job scheduling data formats 


@ e Device types e Error flags 


JOB COMMUNICATION AREA 


Figure E-1 illustrates the first 100g words of the job’s field length. 


@ na 10 WELLL = WL 


+2 


parameters from the program cal! statement 
(available to the user during job execution) 


PGNR, ACTR 


ef yea XUPR, JOPR, FWPR 


Pe a ees 
Sid i 7/77) 
Ce eee 
+67 ' MMMM CSMR, LORR 


+70 : ) CCDR 


command image 


(may be replaced by operator message) 


@ Figure E-1. Job Communication Area 
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Word 


RA+0 


RA+1 


RA+2 
through 
RA+6 3g 


RA+64¢8 ° 


RA+65g 


System 


Identifierf Bit(s) 


ARGR 


PGNR 


ACTR 


CMUR 


LWPR 


59-16 
15 
14 
13 
12 

11-06 

05-00 

59-41 
40 

39-36 


35-00 


59-00 


59-18 
17-00 
59 
58-36 
35-19 


18 


Field 


reserved 
i 

cf 

s 

P 

ssw 
reserved 
sname 

r 

unused 


arguments 


params 


nam 
np 

cm 
clwe 
unused 


lb 


Significance 


Reserved. 


Subsystem idledown flag. 


CFO bit. 


Status bit for pause flag. 


Pause flag. 
Sense switches. 


Reserved. 


System request name (such as CIO). 


Auto recall flag. 


Reserved for future system use. 


Parameters passed to that portion of the 
system that processes the sname request. 


Parameters from the program call command; 
available to the user during execution. 


Name of program called by command. 


Number of parameters in command call. 


Set if the compare/move unit (CMU) is present. 


LWA+1 of loadable area in extended memory. 


Reserved for future system use. 


Library flag: 


0 Load from local file or user library. 
1 Load from system library or global 


library set. 


(You can distinguish a 


global library load from a system 
library load by checking bit 48 of the 
word returned by the GETLC macro.) 


tThese symbols are available to a user program if the program calls a SYSCOM macro. The 
SYSCOM macro is available in both SYSTEXT and NOSTEXT. 
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S. 
© 


System 
Word Identifierf Bit(s) Field 
. 17-00. nwa 
RA+66g =XJPR 59 n 
58-36 clfw 
JOPR 35-24 jot 
23-20 unused 
19 d 
18 r 
FWPR "17-00 wo 
RA+67g = CSMR 59 cs 
LDRR 58-30 unused 
29 c 
28-00 unused 
RA+70g —- CCDR _ 59-00 command 
through image 


RA+778 


Significance 


Address of next word available for loading. 
If Common Memory Manager is loaded in the 
job’s field length, bits 17 through .0 contain 
the complement of the address of the next 
word available for loading (refer to the 
Common Memory Manager Reference Manual). 


Always set to 1 to indicate that the hardware 
feature CEJ/MEJ is available. : 


FWA of loadable area in extended memory. 
Job origin type. ; 

Reserved for future system use. 
DIS flag. | 

RSS flag. 


First word of object ‘program. 


Set if system is running in 64-character set - 
mode. 


Reserved for. future system use. 
Completion flag: 


0 Load not completed. 
1 Load completed. 


_ Reserved for future system use. 


‘Image of command currently being 


executed. 


{These symbols are available to a-user program if the program calls ei SYSCOM macro. The 


SYSCOM macro is available in both SYSTEXT and NOSTEXT. 
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EXCHANGE PACKAGE AREA 


Figure E-2 illustrates the exchange package area for CYBER 180-class models and models 865 


and 875. 


applications programmer and, 


This illustration and the description that. follows it are intended for use by the 


used by applications programs. 


Figure E~2. Exchange Package Area 


therefore, do not include descriptions of bits or fields not 


The exchange package area fields. are defined: as follows (fields are ag to all NOS 
computer systems unless otherwise noted). 


E~ 


Field 


P 


Ai 


Bi 


FL 


Description 
Program address (O<P<FL-1). 
Address registers. 
Increment registers. 
Reference address for central memory. 


Field length for central memory. 
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Field 


EM. 


Flags 


COND 


Xi 
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Description 


Exit modes.’ Specifies the error conditions that cause the system to exit 
normal processing. If a bit is set, and the- -corresponding error occurs, the 
system performs exit processing. If a bit is clear, and the corresponding 
error occurs, processing continues but may produce unexpected results. 


Bits’ 48, 49, and 50 can be set and cleared by the MODE macro (refer to 


section 6). Bits 57, 58, ‘and. 59 are always set by the system and cannot be 
changed by the user. . : : 


Bit(s) / _ Meaning When Bit is Set 

59 - Exit on central memory read parity error or central. memory 
double bit error...This bit is always set. 

58 Exit ‘on central MER Ory AP Rro: PAE EEe error. This bit is 

“s always set. 

57 Exit on parity error on ECS flag register operation. This 
bit is always set. : 

50 Exit on indefinite operand. 

49 All models except model 176: exit on operand out of range 
(infiniteoperand). : 

48 All models except model 176: exit on address out of range. 


Model 176: exit on underflow.t 


Bit . Description 

56 UEM enabled... ' 

55 ‘Expanded addressing select (ESM alia flag). 

54 Extended block copy flag. 

53 Reserved. . 

52 Stack purging on’ models 815, 825, B94 845, and 855 
’ (reserved on other models). j 

51 Reserved. 
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Error condition flags (model 176 only). 


Bit(s) Description 
; 3 
47, 46 Reserved for Control Data. 
45 Extended memory block. range condition. 
44 CM block range: condition. - 
43 Extended memory direct range condition. 
42 CM direct range condition. 
41 Program range condition. 
40 Not used. : 
39 Step condition. 
38 Indefinite condition. - 
37 Overflow condition. 
36 Underflow condition. 


Reference address for extended memory. 


Field length for extended memory. Bit 56 is zero for all applications 
programs. * : ; 


Operand registers. 


Tan address out-of-range condition always causes a program exit on a model 176. 


EJT CONNECTION STATUS CODES 


The following EJT connection status. codes are valid. (These mnemonics. are defined in the 


system OPL common deck COMSEJT. ) 


Code 


PRJS 


EXJS 


ROJS 


SIJS 


s0JS 


Code Value (Octal) 
NICS 0 
DTCS 1 
OLCS 2 
a 3-13 
-- 14-17 
EJT JOB STATUS CODES 


Value (Octal) 


0 


Description 


Not interactive. There is no relationship between a job 
with this connection status and IAF. All batch, remote 


batch, and system origin jobs are assigned this connection 


status. A job in this state is not recoverable. 


Detached. A logical connection existed between a job with 
this type of connection status and an interactive device. 
However, the logical connection no longer exists (due to a 
detach command, line disconnect, IAF abort, or other 
condition). A job in this state continues to execute until 
an interactive request is issued. A job in this state is 
recoverable. 


Qn-line. A logical connection exists between a job with 
this type of connection status and an interactive device. 


Reserved for Control Data. 


Reserved for installations. 


The following EJT job status codes are. valid. (These mnemonics are defined in the system 
OPL common deck COMSEJT.) 


Description 


Preinitial job step. A job is in this state after it has 
been assigned to a control point for the first time. A job 
in this state is available to be scheduied to a control 
point. 


Executing. The job is currently at a control point. 


Scheduler rollout. ‘The job was rolled out by the job 
scheduler because the job’s scheduling priority is lower 
than the priority of another job in the rollout queue. A 
job in this status is waiting to be rolled in to a control 
point. 


SCP rollin. An SCP swapin request was issued to roll in the 
‘job. The job is currently waiting to be rolled in to a 
control point.» 


SCP rollout. The job was rolled out due to an SCP swapout 


request. The job remains rolled out until its job status is 
changed to SIJS. 
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Code Value (Octal) Description 
TOJS : ~5 Timed/event rollout. The job was rolled out because a 


timed/event was posted. The job remains rolled out until 
its job status is changed to ROJS. 


IoJs 6 Interactive rollout. The job rolled out due to interactive 
I/O processing.. The job remains rolled out until its. job 
status is changed to ROJS. 


DOJS 7 é Disabled rollout. The job was rolled out because it was a 
; TXOT. job with no further commands to process. The job 
remains rolled out until the job status is changed to ROJS. 


SUJS ‘ 10 ; Suspended rollout. The job was rolled out because it was 
suspended. The job remains rolled out until the job status 
is changed to ROJS. 


ERJS 11 ; _ Media error on rollout file. The system encountered a mass 
: storage media error during job rollin. 


NVJS 12 Reserved. 
PWJS 13 Preinitial wait. The job has not been through job 
: initiation. Its input file is on an inaccessible device. 
SWS 14 - Service limit wait status. The job is waiting for service 
; limits to allow scheduling. ; 
==. a 15-30 Reserved for Control Data. ° 


- 31-37 Reserved for installations. 


EJT Scheduling Data Field 


The EJT scheduling data field is returned for executing jobs in a QAC PEEK request. The 
information in this field depends on the current stage of. execution of the job. ‘i 


PRJS (Preinitial Job Step) SOJS (SCP Rollout) 


29 
po | emvtime 


EXJS (Executing) 


N 
wo 
o 


_ Scheduling data field not used. 


TOJS (Time/Event Rollout) and PWJS 
(Preinitial wait) 


2923. 11 0 


29 7 11 | aime | EST ordinal 
- control : oe __of event 


I0JS (Interactive Rollout) 


[—) 


ROJS (Scheduler Rollout) ; 
23 11 0 


4 _ 29 
, : word 
entry time count 
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~ 
Bi 
N 
! 
: ° 


SIJS (SCP Rollin) ' §UJS (Suspended) ; 
29 : 11 0 29 23 0 


completion bit j 
relative addr scheduler timeout 


DOJS (Disabled) 


Scheduling data field not used. 


FILE TYPES AND ORIGIN CODES 


The following file types and.origin codes are used in many NOS system. routines. 


The following file types are valid. .(These memonics are defined in NOSTEXT. ) 


Type Value (Octal) . Description 
=). 0-6 Reserved. 
ROFT 7 Rollout. 
LIFT 10 fhaibrerys 
PTFT 11 Pel unc bebe 
PMFT 12 Direct access permanent file. 
FAFT 13 Fast attach file. 
SYFT 14 Systen. 
LOFT 15 Local. 
=> 16 | Reserved. 
INFT 17 Input. 
QFFT 20 Deferred routed queue file. 
-- 21-77 Reserved. 


The following job origin types are valid. (These mnemonics are defined in NOSTEXT. ) 


Type Value (Octal) Description 

SYOT 0 Systen. 

BCOT l Local batch. 

RBOT 2 Remote Gece Cte symbol EIOT is also available but will be 


deleted in a future NOS release). 


TAOT 3 Interactive (the symbol TXOT is also available but will be 
deleted in a future NOS release). 
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SERVICE CLASS TYPES 


The following service class types are valid. The service class code is the first two 
letters of each service class type. These mnemonics are defined in the system OPL common 


deck COMSSCD. 


Type 


SYSC 


BcsCc 
RBSC 
TSSsc 
Disc 
NSSC 
sssc 
MASC 


cTsc 


rosc 
T1sc 
r2sc 
I3SC 


pssc 


Value (Octal) Description 
1 System service class. All jobs initiated by the system, 


15 


16 


Default Service Classes 


except for maintenance jobs and subsystems, are assigned to 
this service class. 


Batch service class. 

Remote batch service class. 

Interactive service class. 

Detached interactive service class. 

Network supervisor service class. 

Subsystem service: class: 

Maintenance service class. 

Communication task service class. All SCOPE 2 Station 
Facility spun-off task (SPOT) jobs and RHF service jobs are 
assigned to this service class. 

Installation service class 0. 

Installation service class 1. 

Installation service class 2. 


Installation service class 3. 


Deadstart sequencing service class. 


The system assigns an initial default service class to each job and each output file. The 
default value depends on the job or file’s origin type. Your site may choose to change its 
default service classes from these released defaults. 


Origin 


SYOT 
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Default Service 


Class 


SYSC 


BCcSC 


RBSC 


TSSC 


DEVICE TYPES 


The following device types are supported by NOS: 


Mnemonic Code _ (Octal 
AT 0124 
cT 0324 
DBn 0402 
DCn 0403 
DDn 0404 
DE 0405 
DFn 0406 
DG 0407 
DHn 0410 
Din 0411 
Dun 0412 
DKn 0413 
DLn 0414 
DMn 0415 

| DN 0416 
DP 0420 
DQn 0421 
DV 0426 
DW 0427 
BAn oso1 
EBn 0502 
ECn 0503 
EDn 0504 
EE 0505 
B-10 


Display Equipment 
ACS Cartridge Magnetic Tape Drive. 
CTS Cartridge Magnetic Tape Drive. 
885-42 Disk Storage Subsystem (one to three units). 
895 Disk Storage Subsystem (one to two units) . 
834 Disk Storage Subsystem (one to eight units). 
Extended memory. 
887 Disk Storage Subsystem 4K sector (one to three units). 
836 Disk Storage Subsystem (one to three units) . 
887 Disk Storage Subsystem, 16K sector (one to two units). 
844-21 Disk Storage Subsystem (one to eight units, half-track). 
844-4x Disk Storage Subsystem (one to eight units, half-track). 
844-21 Disk Storage Subsystem (one to eight units, full-track) . 
844-4x Disk Storage Subsystem (one to eight units, full-track) . 
885-1x Disk Storage Subsystem (one to three units, half-track) . 
9853 Disk Storage Subsystem. 
Distributive data path to extended memory. 
885-1x Disk Storage Subsystem (one to three units, full-track). 


819 Disk Storage Subsystem (one unit, single density; model 176 
only) . 


819 Double Density Disk Storage Subsystem (one unit, double 
density; model 176 only) . 


5830 Disk Array Subsystem; one 5832 SSD drive run in serial 
mode (one to eight units). 


5830 Disk Array Subsystem; two 5832 SSD drives run in parallel 
mode (one to six units). 


5830 Disk Array Subsystem; one 5833 SABRE drive run in serial 
mode (one to two units). 


5830 Disk Array Subsystem; two 5833 SABRE drives: one for data 
and one for parity (one to two units). 


5830 Disk Array Subsystem; two 5833 SABRE drives run in 
parallel mode. 
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Mnemonic 


EF 


i 


OD 
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Cede (Octal 


0506 


1524 


1605 


1624 


1704 


2424 


Display Equipment 


5830 Disk Array Subsystem; three 5833 SABRE drives: two for [ 


data and one for parity. 


Seven-track magnetic tape drive. 


Null equipment. 
Nine-track magnetic tape drive. 
Optical disk drive. 


Interactive terminal. 
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ERROR FLAGS 


NOS sets the following error flags in the user job’s control point area. The user program 


can refer to these flags oeare error exit processing'(refer to the EREXIT macro in 


section 6). 


Error Flag : 
(Octal) Mnemonic Tf Description 
1 TIET User break 1. 
2 TAET User break 2. 
3 ARET Arithmetic error. 
4. ITET SCP invalid transfer adaeee: 
5 . PSET A program stop was encountered by the CPU. 
6 PPET _PP abort. A PP program requested that the job be aborted (CIO 
' or PFM, for example). 
7 CPET CPU abort. The job issued an ABT request. 
10 ' . PCET PP call. error. The job called a nonexistent or invalid system 
request. 
11 rs Reserved for installations. 
12 aay Reserved for CDC. 
13 CLET Command limit. 
14 MLET Message limit. 
15 - * TLET _ Time limit. Job is allowed an.additional 1 to 10 seconds of 
CPU time for error processing. 
16 FLET File limit. The job attempted to assign more active files to 
: the job than are allowed by the validation parameter. 
17 TKET Track limit. The job requested mass storage space on a device 
with none available. 
‘20 SRET SRU limit. The job is allowed an additional 10 SRUs to 
; complete error exit processing. 
‘21 -- Reserved for CDC. 
22 FSET Forced error. 
23 RCET Job hung in auto recall. 
24 ODET The operator dropped the job. 
25 IDET Idle down. 
26TT SPET Beginning of special errors. 
26 -- Reserved for installations. 
27 STET Suspension timeout (EJT error flag only). 
30 ECET ECS parity error. 
31 RSET Subsystem recovered during level 3 deadstart. 
32 SSET Subsystem abort. 
33 a Reserved for CDC. 
34 RRET Operator reran job. 
35 OKET Operator killed job. 
36 ttt NRET ’ Beginning of non-reprievable errors. 
36 a Reserved for CDC. 
37 DRET Deadstart rerun. 
40 RAET . Recovery abort. 
4l JSET Job step abort. 


fIn order to use the mnemonic in a COMPASS program, the program must contain an SST 
pseudo-instruction, and you. must specify either systems text PPTEXT or NOSTEXT. 
TfError flags whose value is greater. than or.equal to that of SPET are considered special 
errors. ; 
Tt TError flags whose value is greater than or equal-‘to that of NRET are considered to be 
non-reprievable errors. 
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Errors greater than or equal to SPET (26g) are considered s 


routines. 


TIn order to use the mnemonic in a COMPASS program the program must contain an SST pseudo- 


Error Flag 

(Octal) Mnemonic fT 
42 SVET 
43 SYET 
44 PEET 
45 SWET 
46 ORET 
47 MXET 

48-77 =-- 


Examples of this are as follows. 


Description 


Security conflict. 

System abort. 

CPU or CM parity error.ff 
Software error abort. 

Override of error condition. 
Maximum number of error flags. 
Reserved. 


pecial by certain system 


The job advancement routine 1AJ does. not invoke buffer flushing when an error occurs 
that is SPET or greater. 


Read and write tape error recovery is terminated by an error greater than or equal 


to 


SPET. 


CIO terminates a skip operation prior to completion if the error is SPET or greater. 


Waiting for a tape to be mounted and waiting for track limit terminate only on 
operator drop (ODET) or an error of value SPET or greater. 


instruction, and you must specify either systems text PPTEXT or NOSTEXT. 
ttApplicable to CYBER 170 Computer Systems only. 


E-12 


60459690 G 


tab 


CPU COMMON DECKS — =F 


Appendix F lists the CPU common decks of general interest to the COMPASS programmer, 
including a list of those common decks that are available in relocatable form on the system 
library (SYSLIB). You can obtain documentation of all CPU common decks provided with the 
system OPL by entering the following commands after’ accessing the system OPL.T 


MODIFY, Z./*EDIT, CALLCPU 
DOCMENT. 


. 


In addition, by using the KRONREF utility to. determine which common decks are associated 


' with which programs, you can examine the PIOETeR listings to obtain examples of the use of 


particular. common decks. 


Since common decks are continually being changed or updated, it is impossible to maintain a 
complete and current description of each common deck in this appendix. Thus, you should: 
consult system listings as described above for specific information. 


CPCOM 


The CPCOM common deck contains macros for commonly used system requests. The macros 
contained in CPCOM are available in systems texts NOSTEXT: and. SYSTEXT. Therefore, you can 
access these macros either- through the system OPL or by abectsyane:, the alternate systems 
text NOSTEXT or SYSTEXT. . or 


The following CPCOM:macros are described in the indicated sections. 


Macro Name Description: ar e Section’ — 
~ ABORT . Abort program aH ig Te 7 11 
APPEND | Append file ee file 5 
ASSIGN Access library file Dies tee 4 
ATTACH Attach direct access file : 5:3 
BKSP ; Backspace file by logical record oat 3 
BKSPRU Backspace file by physical record sy ae 3 
CHANGE ‘Alter permanent file attributes tps od. 5 
CLOCK Get time of day . : : oy : 9 


TYour site must control access to the system OPL as required by.the site’s licensing 
agreement. . Contact your site.analyst to obtain: the.procedure for. gaining .access to the 
system OPL. : 
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Macro Name 


CLOSE 


CLOSER 


CONTROL 


DATE 


DEFINE 


ENDRUN 


EREXIT 


EVICT 


FILEB 


FILEC 


FILINFO 


GET 


HTIME 


JDATE 


LABEL 


‘LOCK 


MEMORY 
MESSAGE 
MOVE 
OFFSW 
OLD 


ONSW 


OPEN 


OVERLAY 
OVWRITE 
PDATE 
PERMIT 
POSMF 


PURGE 


Description — 
Terminate operations on file. 
Close magnetic tape reel 
Read and/or execute command 
Get current date 
Create direct access file 
Request normal program termination 
Specify error processor address ek 
Release file space, save attachment 
Create FET for binary sequential file 
Create FET for coded sequential file 
Get file information| 
Get copy of indirect access file 
Get model 176 clock cycle count 
Get current Julian date 
Assign file to magnetic tape 
Prevent writing on file 
Set amount of memory for job 
Send message to console and dayfile 
Move block of data 


Clear sense switches 


Get copy of indirect access file as primary file 


Set sense switches 

Create file or get file information 
Process request to LDR processor 
Overwrite file with binary pattern 
Get packed date and time 

Permit other user to access file 
Open or position multifile 


Remove permanent file from system 


3 
3 


10 


11 


11 


Section 
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Macro Name 
READ 


READC 


READS 


READSKP 


READW 


RECALL 
RENAME 
REPLACE 
REQUEST 
RETURN 
REWIND 
REWRITE 


REWRITEF 
REWRITER 


RFILEB 
RFILEC 
ROUTE 
RPHR 


RPHRLS 
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Description 


Read data into circular buffer - 

Read coded line from circular buffer into working buffer 
Read PRUs bounded by control words. 

Read data to EOI 


Read coded line from circular buffer into working 
buffer with space fill 


Read logical records from list 

Read S or L format tape data 

Read file to EOF 

Read word from circular buffer into register X6. 


Read and unpack coded line from circular buffer into 
string buffer 


Read until buffer full or EOR or EOF is encountered 


Read specified number of words from-circular buffer 
into working buffer 


‘Relinquish CPU temporarily 


Change name of local file 
Replace indirect access file with contents of local file 


Assign file to device 


Release file from job 


Rewind file 
Write data as random function 


Write entire circular buffer to file as random function, 
end with EOF : 


- Write entire circular buffer to file as random 


function, end with EOR 

Create FET for binary random file 
Create FET for coded random file 
Dispose local. file to queue 
Transfer PRU into circular buffer 


Read PRUs from list 


Section 


3 


3 


Macro Name 


RTIME 


SAVE 


SETFS 


SETPFAC 


‘SETPFAL 


SKIPB 
SKIPEI 
SKIPF 
SKIPFB 
SKIPFF 
STATUS 
STIME 
SYSCOM 
SYSTEM 
TIME 
UNLOAD 
UNLOCK 
USECPU 
USERNUM 


WAIT 


WRITEN 


WRITEO 


Description 
Get real-time clock reading 
Save file as indirect access file 
Set file status 
Set permanent file security access categories 
Set permanent file security access level 
Backspace file by records : > 
Skip to EOI of file 
Skip file forward by records 
Backspace file by files 
Skip file forward by files 
Determine if file exists 
Gee 4o8%e accumulated SRUs 
Define system communication symbols 
Process system request 
Get job’s accumulated CP time 
Release file from job; do not decrement resource count 


Clear write lockout bit for file 


. Select CPU for processing 


Get user name 

Relinquish CPU for specified time 

Write physical record from circular buffer 
Write circular buffer to file 


Write coded line image to circular buffer from working 
buffer 


Write PRUs bounded by control words from circular buffer 
Write entire circular buffer to file, end with EOF 


Pack string buffer to coded line image and write to 
circular buffer, deleting trailing spaces 


Write circular buffer to S or L tape 


Write one word from register X6 to circular buffer 


Section 
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- Macro Name 


WRITER 


WRITES 


WRITEW 


COMCMAC 


Description *, Section 
Write entire circular buffer to file, end. with EOR 3 


Pack string buffer to coded line image and write to 
circular buffer ; 3 


Write specified number of words from mcr ine buffer to 
circular buffer 3 


The COMCMAC common deck contains macros (not available in SYSTEXT) for issuing system 


_. functions for system-oriented programs. The common decks for the processors used must also 
be called by the user program. iat 


The macros defined in common deck COMCMAC are available in ‘systems text PSSTEXT. Therefore, 
you can access these macros either through the system OPL or by specifying the alternate 
systems text PSSTEXT. 


The following COMCMAC macros are described in the indicated sections. 


Macro Name 
CATLIST 
_ CHECKPT 
CSET 
DAYFILE 
DISTC 
EDATE 
EFFECT 
ENCSF 
ETIME 
EXCST 
GETASL 
GETCN 
GETFLC. 
GETFNT 
GETGLS 
GETJA . 
GETJAL. 
GETJCR - 
GETIN 
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Description Section 
Catalog user’s permanent’ files 5 
Create checkpoint dump 10 
Set terminal character set ‘mode 11 
Access dayfile : “A : ~ ql 
Disable terminal control ll 
Edit packed date . 9 
Set/clear format effector mode 11 
Enter new eeusand file 4 
Edit packed time Beas 9 
Execute command 10 
Get account block SRU limit : 6 
Get charge and project numbers 6 
Read field length control word . 6 : 
- Get FNT/FST entry table 4 
Get global library set 6 
Get job accounting words , 6 
Get job security secaseclegeL 6. 
Get job control registers eo 6 
Get job sequence name re ' 6 


Macro Name 
GETJO 
' GETJOSC 
GETJSL 
GETLC 
GETMC 
GETPAGE 
GETPFP 
GETPR 
GETRI 
GETSS 
GETSSID 
GETSSM 
GETTL 
_GETUSC 
LOADD 
LOADQ 
NORERUN 
PRIMARY 
PROMPT 
PSCSF 
RERUN 
ROLLOUT 
SETFAL 
SETGLS 
SETJAL 
SETJCR 
SETJOB 
SETLC 
SETPAGE 
SETPR 


SETSC 


Get 


Description 


job origin code 


job origin and service class codes 


job step SRU limit 

loader control word 
machine characteristics 
page size parameters 
permanent file parameters 
CPU priority | 
reprieve information 
subsystem 

subsystem identifier 


system security mode 


Read job step time limit 


Get 


Load fast dynamic load capsule directory 


Load fast dynamic load capsules 


user service class 


Clear rerun status 


Make file primary 


Disable/enable terminal prompt 


Position command file 


Set 


rerun status 


Roll out job 


Set 


Set 


Set 


Set" 


Set 


Set 


Set 


Set 


Set 


file security access level 
global library set 

job security access level 
job control registers 

user job a 

loader control word 

page size parameters 

CPU priority 


service class 


Section 


11 


‘dl 
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COMCCMD 


Macro Name ae Description © “+ ‘Section 
SETSLM Set screen/line mode oe 11 
SETSS Set subsystem : OG 
SETSSM _ Set secure system memory ae , 6 
SUBR Create subroutine tag ee 
TSTATUS Retura ééruftal status "12 
“4 


” 


The COMCCMD common deck contains macros (not available in SYSTER) for poset seecist job 


‘control and accounting function. requests. 


The macros defined in common deck COMCCMD are available in systems text PSSTEXT. Therefore, 


you access these macros either through the system OPL or by specifying the alternate text 
PSSTEXT. 


The following COMCCMD macros are described in the indicated sections. 


Macro Name — Description — : Section 
GETACT Get outstanding system activity . 7 6 
information’ 

GETEM - Get current exit mode ~ 6 

GETJCI- Get job eentel information | | | 6 

GETLIDA Geereth skteapuees , % a . 
GETLOF . Get list of files pointer 4 . 6° 

GETLVL Get PSR level of NOS it 36 
MACHID Get machine identification : . 6 

MODE Set exit mode flags 6 

PACKNAM Request pack name - ee 6 

PROTECT Set extended memory field length' : 6 

; preservation and/or user file privacy 

REPRIEVE Set vepiteve recesaive . 10 

RPVBLK Create reprieve parameter block ; 10 
SETASL Set account block SRU limit . 6 
SETFET FET aoditizetion macro | 2 
SETJCL © .  Set/clear job control parameters. 6 
SETJSL Set job step SRU limit | 6 
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Macro Name 
SETLOF 
SETMFL 
SETRFL 
SETTL 
SHELL 


VERSION 


comcarc ft 
| COMCARM 


comccnp ft 


CoMccFp tf 


COMCCHD 


comccio ft 


comccop tf 


comccpa ft 


COMCCPM 


comccrt ft 
COMCCVI 
COMCCVL 
COMCDCM 
COMCDCP 


COMCDXB 


Common Deck 


Description Section 
Set list of files pointer 6 
Set job maximum field length 6 
Set job step initial field length 2 6 
Set job step time limit 6 
Set controls for shell program 6. 
Get operating system version name 6 


OTHER COMMON DECKS 


The following common decks are also available to you on-the system OPL. 


Description 
Processes an argument list by the use of an equivalence table. 


Processes multiple word arguments. 


' Converts a binary integer to display code decimal digits with leading 


zero suppression. 
Converts a 30-bit integer.to display code in FORTRAN F10.3 format. 


Converts up to a 10-digit decimal number. (40 bits) to hexadecimal 
display code with leading zero suppression. 


Performs I/O functions. 


Converts a binary integer to display code octal digits with leading 
zero suppression. 


Converts positional arguments in an input string to keyword arguments 
in an output string. 


Calls the PP program CPM to perform tasks involving control point 
activity. 


Copies prefix table comments to a print line. 

Contains formulas for converting validation index value to limit value. 
Common validation interface processor. 

Display console communication macros. 

Display console communication processor. 


Converts one word of display code digits to a binary value. 


| “Fhe gout common deck is also available on the program library (PL) that contains the common 
decks that are common between products. Contact site personnel for further information. 
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Common . Deck 


COMCECM 
COMCECS 
COMCEDT 


COMCFCE 


COMCGTO 


COMCHXB 


COMCLFM 
COMCLOD 


comcmTMt ° 


comcmTet 
comcmvet * 
COMCOVL 
COMCPFM 
“COMCPOP 
_ COMCRDCT 


coMcRDHtT 


comcrpot 


comcrpst 
comcrpwt 


- COMCRSP 
COMCSEM 
comcsENt 


COMCSNM 


Description 
pot tahoe sirclabatant 


Contains macro definitions for performing interpretive mode extended . 
memory reads and writes (refer to appendix D). 


Processes interpretive mode extended memory read and write instructions 


(refer to appendix D). 


Edits an 18-bit packed date or time into a 10-character display coded 
date or time. ; 


Edits a permanent file’ catalog entry’into a three-line output formula. 
Returns the terminal ordinal corresponding to the supplied terminal 


mnemonic or the terminal mnemonic corresponding to the supplied 
terminal ordinal. ; 


Converts one word of hexadecimal display code digits to a binary value; 


leading and trailing blanks are ignored. 


Processes requests for the PP program LFM. 
User call loader interface. 


Contains macro for generation, allocation, and processing of managed 
tables. 


Contains goaednse for processing aaaged tables. 

Moves a block of data. 

Requests the PP program LDR to load a specified overlay. 

Performs nevaaient file action functions by calls to the PP program PFM. 
Obtains parameters from aeons titfers 

Reads one coded line from a CIO buffer to'a working buffer. - 


Reads one coded line from a CIO buffer to a working buffer with 
trailing space fill. 


Reads one word from a CIO buffer to the X6 register. 


Reads one coded line from a CIO buffer to a working buffer where it is 
stored one character per word. ‘ 


Reads the specified number of words from a CIO buffer to a working 
buffer. ; : 


Removes secure parameters from command. 
Processes requests for the PP program SFM. 
Replaces trailing 00 codes with 55 codes in a word. 


Sets name in message. 


tThis common deck is also available on the program library-(PL) that contains the common 


decks that are common between products. Contact site personnel for further information. 


60459690 H 


F-9 


Common Deck 


SYS 


comcsrt ft ° 


COMCSSN 
COMCSST 
COMCSTF 


COMCSYS 


+ + + 


COMCUPC 
COMCUSB 


COMCVDT 
COMCVLC 

comcwop ft 
comcwrc ft 
coMcWTH Tf 


comcwro ft 


comcwts f 


comcwrw tT 
COMCZAP 


comczTs t 


LIB 


Description 


Identifies the format of a record from the first 64 words located in a 


working buffer. 


Skips a sequence number on a coded line if present. 


Sorts a table into ascending order using a shell-sorting technique. 


Determines if a file is, or will be, assigned to a terminal. 


Contains routines for processing system request. 


Unpacks a command to individual parameters. 


Unpacks data block to string buffer. 


Converts a display-coded date (yymmdd) or time (hhmmss) to a packed 
binary value and checks the validity of the entry. 


Converts an access level or access category name to the corresponding 
binary value, or vice versa. 


Converts a word to octal display code by an- in-line sequence of shifts 


and masks. 


Transfers one coded line in C format from a working buffer to a CIO 


buffer. 


Transfers one coded line in H format from a working buffer to a CIO 
buffer; trailing spaces are deleted. 


Writes one word to a CIO buffer from X6. 


Transfers one coded line from a string buffer to a CIO buffer with 
trailing space suppression. 


Transfers data from a working buffer to a CIO buffer. 


Z argument command processor. 


Replaces all 00 codes with 55 codes in a word. 


The following common decks, unless otherwise noted, are assembled from the PL that contains 
the common common decks and are available in relocatable form on the system library SYSLIB. 


Common Deck 


COMCCIO 


comccem tt 


Entry Points 


cIO= 


CPM= 


Description 
1/0 function processor 


Control point manager processor 


This common deck is also available on the program library (PL) that contains the common 


decks that are common between products. 


TAssembled from the system OPL. 
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Contact site personnel for further information. 
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Common Deck 
comcecst 
COMCLFMt 

_ COMCMVE 
COMCOVLT . 
comcprét 
COMCRDC 
COMCRDH — 
COMCRDO 
COMCRDS 
COMCRDW 


COMCSYS 


COMCWTC 
COMCWTH 
COMCWTO 
COMCWTS 


COMCWIW 


Entry Points 
REC=, WEC= 
LFM= 


MVE=. 


-RDS= 


LCB=, RDW=, RDX= 


MSG=, RCL=, 
SYS=, WNB= 


WICc= 
WTH= 


WIo= 


Tassembled from the system OPL. 
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Description 
Extended memory interpretive mode macro processors 
Local file manager processor 


Move block of data 


. Overlay load: processor 


Permanent file processor 

Read coded line, -C- format 

Read coded Line, -H- format 

Read one word 

Read coded lire to string buffer 
Read words to working buffer 


Process system request 


Write coded line, -C- format 

Write coded ind, -H- format 

Write one word 

Write coded line from string buffer 


Write words from working buffer 
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BINARY FORMATS 


Appendix G describes the following binary formats. 


PP 
OPL 
OPLD 
ULIB | 
TEXT 


PROC 


CYBER 180, CYBER 170, CYBER 70, or. 6000 Computer Systems PP absolute program 


Modify old program library deck 


Program library directory 


User library group 


Unrecognized as binary ey 


Procedure 


Compressed compile file © 


For binary formats of loader and tables, refer to the (CYBER Loader Version 1 Reference 


Manual. 


PP—CYBER 180, CYBER n70; CYBER 70, OR 6000 COMPUTER SYSTEMS 
PP. ABSOLUTE 


Binary output for a CYBER 170., CYBER 70, or 6000 Computer Systems PP program or overlay is a 
logical record that may contain the following: 


e Prefix table 


- @ CYBER 170, CYBER 70, or 6000 Computer Systems PP program control table 


e PP text in five PP words per 60-bit CPU word 


The format of the control table is: 


59 


Bits 


59-42 


41-36 
35-24 
23-12 


11-0. 


Field 


name 


none 
fwa 
none 


length 


“| 35 23 us te] 
ee ee ee ee 


‘Description 


Program name, one- to three-display code characters, left-justified 
with zero fill. 


Reserved for future system use. 
Origin minus 5; address at which the header word is loaded.f 
Reserved for future system use. 


Number of CPU words in program image (1/5 the number of PP words). 


{The normal origin address for PP programs is 1100g (PPFW); however, the origin address 
should be greater than 5. 
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OPL—MODIFY OLD PROGRAM LIBRARY DECK © 


A Modify old program library deck is a record on a Modify library file (figure G-1) 
consisting of a prefix table, a modification table, and text. The prefix table contains the 
library creation date in word 2 and the latest modification date in word 3. 


prefix table, 
modification table, 


End-of-record, 


modification tableo 


Deck (record), 


Deck (record)o 


End-of-records 


erefix tables 


End -of-recordy,-1 


prefix tablen 
modification table, 


; End- of -recordy 


prefix tablen+4 


End -of -recordy, 44 . 


Deck (record) pn 


End-of-information 


Figure G-1. Modify Library File Format 
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MODIFICATION TABLE FORMAT 


Modification table format is shown in figure G-2. 


47 17 "1 


40 
a ys 
ee 7 


Figure G-2. Modification Table Format 


Word Bit(s) Field - | Description 
ID 59-48 700X . Identifies Modify deck. Least significant digit . 


‘.indicates whether or not the deck is common as follows: 


1 Deck is not, common. 
2 Deck is common. 


47-12 none Reserved for future system use. 
11-0 “ - Number of modification names in table. 
word; 59-18 modname; One~ to seven-character modification set name. Each 


modification to. a deck causes a new entry in this.table. 
16 Yi , YANK flag: 


OQ Modifier not. yanked. 
1 Modifier yanked. 


60459690 A we G-3 


TEXT FORMAT 


Text is an indefinite number of words that contain a modification history and the compressed 
image of each line in the deck. Text for each line is in the format shown in figure G-3. 


CS ee 
VU a 


Figure G-3. Modify Text Format 


Bit(s) Field Description 


59 a Activity bit: 


0 Line is inactive. 
1 Line is active. 


58-54 ~ we Number of words of compressed text. 


53-36 seq. no. Sequence number. of. card (octal) according to the position 
in the deck or modification set. : 


"35-18 mhb; Modification history byte. Modify creates a byte for 

and each modification set that changes the status of the 

subse- ; card. Modification history bytes continue to a zero byte. 
quent Since this zero byte could be the first byte of a word 

18-bit and the compressed card image beings a new word, the 

bytes - : modification history portion of the text could terminate with a 


zero word. 


The format of mhb; is: 


a Activate bit: 


0 Modification set deactivated the card. 
1 Modification set activated the card. 


mod. no. Index to the entry in the modification table 
that contains the name of the modification 
set that changed the card status. 
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Following the modification history bytes is the compressed image of the card in display 
code. A single space is represented by 55g; it is not compressed. Two or more embedded 
spaces are replaced in the image as follows: 

3 spaces replaced by 0002 

4 spaces replaced by 0003 


64 spaces replaced by 0077, 
65 spaces replaced by 007755 
66 spaces replaced by 00770001. 
67 spaces replaced by 007700028, etc. 


Trailing spaces are not considered as embedded and are not included in the card image. A 
12-bit zero byte marks the end of the card. é . 


| 


Existing 63-character set program libraries 
may have two spaces represented as a 0001 
byte. : : 


OPLD—PROGRAM LIBRARY DIRECTORY 


The library file directory (figure G-4) contains a prefix (7700) table followed by a table 
containing a-two-word entry for each deck in the library. Directory entries are in the same 
sequence as the decks on the library. 


47 29 oe O 
| 
ee 


random addresso 


deckname ten/2 , type len/2 
p len/2 random address len/2 


Figure G-4. Library File Directory Table 
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Word Bits Field : . Description 


ID 59-48 7000 Identifies the table as a program library directory. 
17-0 len Directory length excluding ID word. 
1,3, 59-18 dec kname; Name of the program library deck; one to. seven characters, 
eer ; : -left-justified. If typey equals 16g, this field 
len-1 contains the capsule name. é 
17-0 type; Type of record (octal): 
O Unrecognizable as binary program (TEXT). 
1 Peripheral processor program (PP). 
3 Relocatable central processor program (REL). 
4 Central processor overlay (OVL). 
5 User library program (ULIB). 
6 Old program library deck (OPL). 
7 Old program library common deck (OPLC). 
10 Old program library directory (OPLD). 
11 Multiple entry point overlay (ABS). 
12 Peripheral processor unit program (PPU). 
16 Fast dynamic load capsule (CAP). 
20 Procedure (PROC). 
2,4, 59-30 Pj.- Zero for all record types except CAP (16g). If type; 
eee,len equals 16g this field is defined as follows. 
Bits - ’ Description 
59-48 Ordinal to group name in ULIB record (refer 
to ULIB record). 
47-30 Length of capsule. 
- 29-0 random Address of the deck relative to the beginning of the file. 
address; ; sieht : ae 
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ULIB—USER LIBRARY GROUP 


A user library group (figure G-5) consists of all records -beginning with.a ULIB-type record 
through the next OPLD-type record. The ULIB record format is shown in figure G-6 and the 


ULIB deck entry/externals format is shown in figure G-7. 


PREFIX TABLE 


-  ULIB RECORD 


END-OF-RECORD 


END-OF-RECORD 


END-OF-R ECORD 


| Deck | 


END-OF-RECORD. 


END-OF-RECORD 
OPLD RECORD | 


END-OF-RECORD 


Figure G-5. User Library (ULIB) Format 
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G-7 


group 
nam ey 


county; 


eC 
Cra eM 


Prefix 
Table 


group name, capsule count , 


ULIB 


I Deck, Entry/Externals Table ] Table 
Decko Entry/Externals Table 


Oeckn Entry/Externals Table 


Group count (count of different group names in ULIB) equal to m. 
Random address of OPLD. 
Cross-reference flag: 


0 ULIB table contains cross-references. 
1 ULIB table does not contain cross-references. 


Name of group. 


capsule Number of capsules with group name;, 


Figure G-6. ULIB Record Format 
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59 «56 29 


ee  /// 
an (OC Y/// 


ee 
th t;p\WYYYiYHYf,_a_| ____randomascressotdeck; | 
\GYiiffyfyyvy 
GY Yip racom sces of exeral | 
QCM 


New format flag. When set, all record type codes appear in the rt field. 
Otherwise, only command callable record type codes appear, that is, PROC, 
ABS, OVL (0,0) and some REL. 


Command callable. When both nf and cc are set, the record referenced may 
be called by a command. 


Record type - same as type field of OPLD record entries. 


Figure G-7. ULIB Deck Entry/Externals Format 


TEXT - UNRECOGNIZED AS BINARY 


A text record is any record that cannot be recognized as conforming to a specific binary 
format. The record name is taken from the first one through seven display code characters 
in the record (if a prefix table is present, the record name will be taken from that table 
instead) . 


PROC - PROCEDURE 


A PROC record is a special form of text record in which the first line has the following 
format: 


- PROC, procnam 


The record name is the one- through seven-character alphanumeric identifier procnam. 
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COMPRESSED COMPILE FILE 


A compressed compile file (figure G-8) has a one-word header. 


59 47 35 17 1 0 


2 
compressed line 


modname , | @ 


compressed line py 


char set Character set of the compressed compile file: 


0 63-character set. 


64 64-character set. : | & 
One- 


to seven-character modification set name. 


Sequence number of the line image according to the position in the 
deck or modification set. 


Figure G-8. Compressed Compile File Format 
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EXAMPLES OF RANDOM I/O H 


Appendix H contains several programs that perform the following random I/O operations. 
e Create a random file 
e@e Read a random file with list 
e Write (replacing records) on a random file , 


The COMPASS program illustrated in figure H-1 reads the input deck in figure H-2 and creates 
a random file in the format illustrated in figure H-3. The resulting index directory record 
is also illustrated. ; 


An example of a program which uses the READLS (read with list) macro to retrieve (read) a 


-list of records from the same random file is illustrated in figure H~4. 


Figure H-5 illustrates two ways of writing (replacing) records on a random file. The new 
record 1 is written at EOI; that is, at the same random address. Record 3 is written to the 
file by using the REWRITER macro, which rewrites in place. : 
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H-2 


Cc 


* 


+ FF Fe HF OF OF 


REATE 


COMMENT 


FWA 

I 

INPUT 

R 
RANFILE 
MAXI 


CREATE 


cR1 


- EQU 101B 


Figure H-1l. 


IDENT CREATE,FWA 

ABS 

SST 

TITLE CREATE - CREATE RANDOM FILE. 
ENTRY CREATE 

ENTRY RFL= 

SYSCOM B1 

CREATE RANDOM FILE. 

COMMENT COPYRIGHT CONTROL DATA 1982. 
SPACE 4, 10 

CREATE - CREATE RANDOM FILE. 
PROGRAMMER NAME. 82/04/26. 

SPACE 4, 10 


THIS PROGRAM CREATES A RANDOM FILE AND DIRECTORY FROM 


DATA SUPPLIED ON FILE INPUT. 
FORMAT OF INPUT - 


CARD 1 COLUMN 1-2 RECORD NUMBER RIGHT JUSTIFIED 


- CARD 1 COLUMN 11-20 RECORD NAME 
CARD 2-N COLUMN 1-80 RECORD DATA 
CARD N EOR 
REPEAT SEQUENCE - 

MAX. 64 RECORDS 


FILE IS WRITTEN TO RANFILE. 
SPACE 4, 10 
DAYFILE MESSAGES. 


* INDEX QUT OF RANGE.* = INDEX INPUT .GE. 64. 
* RANDOM FILE CREATED.* = PROGRAM COMPLETE. 
SPACE 4, 10 

PROGRAM CONSTANTS. 


EQu 1018 


INPUT BUFFER LENGTH 
INDEX LENGTH 
EQU 10B WORKING STORAGE BUFFER LENGTH 


EQU 10018 
TITLE MAIN PROGRAM. 
ORG 110B 


FILE CREATION BUFFER 


BSS 0 

BSS 0 INPUT FET 
FILEB IBUF,IBUFL 

BSS 0 

RFILEB RBUF,RBUFL, CIND=INDEX, INDL) 
CON MAXIMUM INDEX 


SB1 
REWIND 
READ NEXT RECORD 


IF END OF FILE 


COMPASS Program to Create a Random File (Sheet 1 of 3) 
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SB7 SET OCTAL CONVERSION 

RJ CONVERT DIGIT 

NZ IF. ERROR IN RECORD NUMBER 
BX5 SAVE RECORD NUMBER 


RECALL . . 
READO READ RECORD NAME 
NG IF END OF FILE 


. MXO SET ADDRESS OF RECORD IN INDEX. 


SA1 

Lx1 

BX6 

BX1 

BX6 

SA6——sINDEX#X5 

SA1 MAXI 

1x1 X1-X5 
PL X1,CR2 IF NOT LARGEST INDEX 
BX6 = X5 SET NEW MAX. INDEX 
SA6 A 

READC 1,WORK,WBUFL 

NG X1,CR4 IF END OF FILE 

NZ X1,CR3. IF END OF RECORD 
WRITEC R,WORK ,WBUFL 

EQ CR2 

WRITER R 

EQ cR1 READ NEXT RECORD 


WRITE INDEX. 


RECALL R 

SA1 MAXI 

WRITEW R,INDEX,X1+1 

WRITER R,R 

WRITEF R,R 

REWIND R ; 

MESSAGE (=C*RANDOM FILE CREATED.*),,R 
ENDRUN 


MESSAGE (C=*INDEX OUT OF RANGE.*),,R 


ABORT 
SPACE 4, 10 
COMMON DECKS. 


COMCRDO 
COMCCIO 


‘COMCWTW 
. COMCWTC 


COMCRDC 
COMCSYS 
COMCRDW 
COMCDXB 


Figure H-1. COMPASS Program to Create a Random File (Sheet 2 of 3) 


10 

THIS IS 
-EOR- 
03 

THIS IS 
-EOR- 
07 

THIS IS 


THIS IS 
-EOR- 
05 

THIS IS 


THIS IS 
~EOR- 
04 

THIS IS 


THIS IS 
~EOR- 
-EOI- 


LITERALS 


BUFFERS. 


BSSZ 
EQU 
EQU 
EQU 
EQU 
END 


INDL INDEX BUFFER 

* INPUT BUFFER 
IBUF+IBUFL RANDOM FILE BUFFER 
RBUF+RBUFL WORKING BUFFER 
WORK+WBUFL JOB FL 


Figure H-1. COMPASS Program to Create a Random File (Sheet 3 of 3) 


REC10 


RECORD NUMBER 


REC3 


RECORD NUMBER 


REC? 


RECORD NUMBER 


REC2 


RECORD NUMBER 


RECS 


RECORD NUMBER 


REC1 


RECORD NUMBER 


REC4 . 
RECORD NUMBER 


REC6 


RECORD NUMBER 


Figure H-2. Input File for Program Creating a Random File (Figure H-1) 
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RANDOM FILE FORMAT INDEX. RECORD 


Figure H-3. Structure of the Random File Created 


H-6 


* COMMENT 


RANFILE 
0 
OUTPUT 
LIST 


RLIST 


Figure H-4. 


IDENT RLIST,FWA 
ABS 
SST 
TITLE RLIST - READ SELECTED LIST FROM RANDOM FILE. 
ENTRY RLIST 
ENTRY RFL= 
SYSCOM B1 . 
READ LIST OF RANDOM FILE. 
COMMENT COPYRIGHT CONTROL DATA 1982. 
SPACE 4, 10 
RLIST - READ SELECTED LIST FROM RANDOM FILE. 
PROGRAMMER NAME. 82/04/26. 
SPACE 4, 10 
THIS PROGRAM READS A SELECTED LIST OF RECORDS 
FROM RANDOM FILE AND WRITES THEM TO FILE OUTPUT. 
SELECTED LIST IS - 
3 
? 
4 
10 
SPACE 4, 10 
DAYFILE MESSAGES. 


*INDEX OVERFLOW.* = INDEX BUFFER OVERFLOWED. 
*LIST COPIED.* = PROGRAM COMPLETE. 
SPACE 4, 10 


PROGRAM CONSTANTS. 


EQU 101B INDEX LENGTH 

EQU 101B RANDOM FILE BUFFER LENGTH 
EQU 101B OUTPUT BUFFER LENGTH 

EQU 108 WORKING BUFFER LENGTH 
TITLE MAIN PROGRAM. 

ORG 110B 


BSS 0 


BSS 0 

RFILEB RBUF,RBUFL, CIND=INDEX,INDL) 
BSS 0 

FILEB OBUF,OBUFL 

BSSZ 10B LIST TO READ 


$B1 1 

SKIPEI R,R POSITION TO INDEX 
BKSP =R,R 
BKSP  =R,R 
READ R,R READ INDEX 

READW R,INDEX, INDL 

ZR X1,ERR IF INDEX TOO LARGE 


SET LIST OF RECORDS. 


of Records from a Random File (Sheet 1 of 2) 


COMPASS Program Using READLS Macro to Retrieve a List 
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MxO 42 of 

SA1 INDEX+3 RECORD 3 
BX6 -XO*X1 

SA6 _ LIST 

SA1 INDEX+7 RECORD 7 
BX6 -XO*X1 

SA6 ‘A6+B1 

SA1 INDEX+4 RECORD 4 
BX6 -XO*X1 

SA6 A6+B1 

SA1 INDEX+10B RECORD 10 
BX6 -X0*X1 

SA6 A6+B1 

SX6 LIST . SET ADDRESS OF LIST 
SA6 R+5 


READ LIST. 


READLS R,R 

READW R,WORK ,WBUFL . 
NG X1,RLI3_-—sIF_END OF FILE 
WRITEW 0,WORK ,WBUFL 

EQ RLI2 


SXx1 B6-WORK 

WRITEW 0,WORK,X1 

WRITER O 

REWIND R 

MESSAGE (=C*LIST COPIED.*),,R 
ENDRUN 


MESSAGE (=C*INDEX OVERFLOW.*),,R 
ABORT : 
SPACE 4, 10 

COMMON DECKS. 


cOomMCCIO 

COMCWTW 

COMCRDW 

COMCSYS 
SPACE 4, 10 
USE LITERALS 


BUFFERS. 


EQU * INDEX BUFFER 

EQU INDEX+INDL RANDOM FILE BUFFER 
EQU RBUF+RBUFL OUTPUT BUFFER 

EQU QOBUF+OBUFL WORKING BUFFER 

EQU WORK+WBUFL DEFAULT FL 

END 


Figure H~4. COMPASS Program Using READLS Macro to Retrieve a List of 
Records from a Random File (Sheet. 2 of 2) ; 
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REWRITE 


*COMMENT 


R 


’ RANFILE 


INDS 


REWRITE 


IDENT REWRITE,FWA 
ABS 
SST 
TITLE REWRITE - REWRITE RANDOM FILE. 
ENTRY REWRITE 
ENTRY RFL= 
SYSCOM B1 
REWRITE RANDOM FILE 
COMMENT COPYRIGHT CONTROL DATA 1982. 
SPACE 4, 10 
REWRITE - REWRITE RANDOM FILE. 
PROGRAMMER NAME. 82/04/26. 
SPACE 4, 10 
THIS PROGRAM UPDATES RECORDS ON A RANDOM FILE. 
RECORD 3 IS UPDATED IN PLACE 
RECORD 1 IS REWRITTEN AT EOI 
THE DIRECTORY IS ALSO REWRITTEN 
SPACE 4, 10 
DAYFILE MESSAGES. 
*INDEX OVERFLOW.* = INDEX TOO LARGE FOR BUFFER 
SPACE 4, 10 
PROGRAM CONSTANTS. 


EQU 101B INDEX LENGTH 

EQU 1018 RANDOM FILE BUFFER LENGTH 
TITLE MAIN PROGRAM. 

ORG 1108 


BSS 0 


BSS 0 
RFILEB RBUF,RBUFL, CIND=INDEX,INDL) 
CON 0 


SB1 1 7 
SKIPEI R POSITION TO INDEX 
BKSP R 
BKSP R 

R 


READ , READ INDEX 
READW R,INDEX,INDL 


ZR X1,ERR IF INDEX TOO LARGE 
BX6 x41 SAVE INDEX SIZE 
SA6 INDS 


R 
R 
R 
R 


CHANGE RECORD 3 IN PLACE. 


SA1 INDEX +3 SET ADDRESS OF RECORD 3 
MXO = 42 

BX6 = -XO*X1 

SA6 —-R¥6 

WRITEC R,(=C*#REC3-1%) 

WRITEC R,(=C*THIS IS UPDATED RECORD 3.*) 
REWRITER R,R 


Figure H-5. COMPASS Program to Replace Certain Records on a 
Random File (Sheet 1 of 2) | 
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REWRITE RECORD 1 AT EOI. 


SKIPEI R,R ‘POSITION FILE AT EOI 


“SA1 
“MXO 


LXx1 

SA2 INDEX +1. 

BX6 X0*X2 PICK RECORD NAME 
Bx1 -X0*X1 

BX6 X1+X6 ' REWRITE NEW ADDRESS 
SA6 - A2 


WRITEC R,(=C*#REC1-1*) 


WRITEC R,(=C*THIS IS UPDATED RECORD 1.*) 
WRITEC R,(=C*WRITTEN AT EOI BECAUSE LENGTH IS EXTENDED.*) 
WRITER R,R 


REWRITE INDEX. 


SA1 INDS 
WRITEW R,INDEX,X1 
WRITER R,R 
WRITEF R,R 


REWIND R 


MESSAGE (=C*RANFILE UPDATED.*) ,,R° 
ENDRUN 


MESSAGE (=C*INDEX OVERFLOW.*),,R 
ABORT 

SPACE 4,10 

COMMON DECKS. 


COMCCIO 


‘COMCWTC 


COMCRDW 

COMCWTW 

COMCSYS 

SPACE 4,10 
USE —_LITERALS 


BUFFERS. 

equ * 

EQU: INDEX+INDL RANDOM FILE BUFFER 
EQU §RBUF+RBUFL DEFAULT FL 


END 


Figure H-5. COMPASS Program to Replace Certain Records on a 


Random File (Sheet 2 of 2) 
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-PROGRAMMING STANDARDS . | 


This appendix describes NOS programming standards including documentation standards and 
coding specifications for COMPASS programs. A COMPASS program follows these standards for 
one or more. of the following reasons. 


.@ To allow the correct use of the NOS documentation processor DOCMENT 
e To ease readability and modification for other programmers 


e To optimize execution and memory requirements 


DOCUMENTATION STANDARDS | 


Documentation is the presentation of information about a program‘in ‘easily understandable 
form so that those who need to understand a program do not need to study the program 
itself. The program documentation is embedded within the source language of each program. 
The documentation should be designed to be extractable by the NOS documentation processing 
program DOCMENT. This approach serves to unify the program and’ its documentation, making 


it easier and more natural to update as changes are made. 


NOS documentation is of two types. 
e External documentation is produced for the general user 


e Internal documentation describes the internal characteristics of a program (such as 
register usage and subroutine entry and exit conditions) 


For a detailed explanation of how to obtain external and internal documentation, refer to 
the description of the DOCMENT command in Volume 3, System Commands. 


External and internal documentation are further divided in the following levels of 
documentation. 


@ How the program functions (design overview) 
e How the program is used (external interface) 
e How.the program works (internal interface) 


e Information needed to modify the program (detailed code analysis)- 


DESIGN OVERVIEW . 
The design overview of a program should describe in general terms the function of the 


program. It should.not contain any information about the input paremeterss options, error - 
conditions, or internal workings of the program. - : 
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EXTERNAL INTERFACE 
The external interface description includes the following: 
e Parameter definitions, formats, and contents 
e Initial conditions of buffers and devices 
@ Status and condition information 
@ Programs called | 


@ Error codes and messages 


e Parameters returned 


INTERNAL INTERFACE 


The internal interface describes the logical flow and structure of the program, the 
algorithms used, and the function performed by each overlay or subroutine in the program. 


DETAILED CODE ANALYSIS | 


The detailed code analysis consists of comments within the code itself describing the flow 
of the program. Comments describing the function of logical groups of instructions should 
be provided, and comments documenting table structures, data areas, and constants should 
appear on the instructions which define them. This documentation should provide enough 


detail so that program modifications can be made without adversely affecting existing 
program functions. 


Figure I-1 is an example of how source code could be arranged to take advantage of the 


DOCMENT features. Figure I-2 illustrates an external DOCMENT of that program and figure 
I-3 illustrates an internal DOCMENT. | 


COMMENT STATEMENT DOCUMENTATION 


Comment statements contain only asterisks and blanks in the first 10 columns and text in 
columns 11 through 71 (columns 72 through 80 are not used). The following rules apply to 
the format of comment statements for documentation. 


e Comment statements with an asterisk only in column 1 indicate that this statement 
is a continuation of internal and external documentation, or it is a comment 


' statement not included in the formal documentation (that is, it is not processed by 
DOCMENT). 


e Comment statements with asterisks in columns 1 and 2 indicate internal 
documentation. 


e Comment statements with asterisks in columns 1, 2, and 3 indicate that this 
statement and all following statements are internal and external documentation, 
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e A statement with four asterisks beginning in column 1 indicates that all following 
statements are internal documentation (whether they are comment statements or not). 
Documentation ends when another comment statement containing four asterisks is 
encountered. 


e A statement with asterisks in columns 1 through 5 indicates that this and the 
following comment statements are internal and! external documentation and provide 
the program overview. ; 

e A statement with an asterisk in column 1 and blanks in columns 2 through 71 is a 
blank comment statement and is used as a separator to improve readability of 
documentation. 
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TS YM 


DOC TEST 
wk 


DOCTEST 


* 


DOCA 


IDENT DOCTEST 

ENTRY DOCTEST 

SYSCOM B1 

TITLE DOCTEST - DOCMENT TEST PROGRAM. 

SPACE 4,10 

DOCTEST - DOCMENT TEST PROGRAM. 

THIS PORTION OF THE DOCUMENTATION CONTAINS THE 
PROGRAM OVERVIEW. 


A. B. PROGRAMMER. 82/04/26. 

SPACE 4,10 

DOCTEST IS A COMPASS PROGRAM WHOSE DOCUMENTATION 
USES SEVERAL OF THE FEATURES PROVIDED BY THE NOS 
DOCUMENT PROCESSOR *DOCMENT *. 

SPACE 4,10 

DAYFILE MESSAGES. 


* DOCTEST COMPLETE.* — INDICATES COMPLETION OF 
PROGRAM EXECUTION. 

SPACE 4,10 

ASSEMBLY CONSTANT. 


Ew 3 CONSTANT THREE 


TITLE DATA STORAGE. 
DATA STORAGE. 


CON O TEMPORARY LOCATION 
SPACE 4,10 

TSYM - TABLE OF SYMBOLS. 

30/ THREE, 12/0, 18/ TEMP 


THREE VALUE OF EQ SYMBOL. 
TEMP VALUE OF TEMPORARY STORAGE LOCATION. 


. BSS 0 


VFD 30/THREE,12/0,18/ TEMP 
TITLE MAIN ROUTINE. 
DOCTEST MAIN ROUTINE. 


SB1 1 

DAYFILE MESSAGE INDICATING EXECUTION IS COMPLETE. 
MESSAGE DOCA, THREE 

ENDR UN 


DATA Cx DOCTEST COMPLETE.* 
SPACE 4,10 
END DOC TEST 


Figure I-l. Source Code for DOCMENT 


DOCTEST - DOCMENT TEST PROGRAM. 
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82/04/26. EXTERNAL 


DOCTEST - DOCMENT TEST PROGRAM. 
THIS PORTION OF THE DOCUMENTATION CONTAINS THE 
PROGRAM OVERVIEW. 


A. B. PROGRAMMER. 82/04/26. 


DOCTEST IS A COMPASS PROGRAM WHOSE DOCUMENTATION 
USES SEVERAL OF THE FEATURES PROVIDED BY THE NOS 


- DOCUMENT PROCESSOR *DOCMENT*. 


DAYFILE MESSAGES. 


* DOCTEST COMPLETE.* -— INDICATES COMPLETION OF 


“PROGRAM EXECUTION. 


Figure I-2. External Documentation of Program 


DOCTEST - DOCMENT TEST PROGRAM 82/04/26. INTERNAL 


DOCTEST - DOCMENT TEST PROGRAM. 
THIS PORTION OF THE DOCUMENTATION CONTAINS THE 
PROGRAM OVERVIEW. 


A. B. PROGRAMMER. 82/04/26. 


DOCTEST IS A COMPASS PROGRAM WHOSE DOCUMENTATION 
USES SEVERAL OF THE FEATURES PROVIDED BY THE NOS 
DOCUMENT PROCESSOR *DOCMENT*. 


DAYFILE MESSAGES. 


* DOCTEST COMPLETE.* — INDICATES COMPLETION OF 
PROGRAM EXECUTION. 


ASSEMBLY CONSTANT. 


EQU 3 CONSTANT THREE 


DATA STORAGE. 


TSYM - TABLE OF SYMBOLS. 


5 4 3 2 1 


987654321098765 4321098765 4321 0987654321098765432109876543210 


/ THREE 


THREE VALUE OF EQU SYMBOL. 
TEMP VALUE OF TEMPORARY STORAGE LOCATION. 


DOCTEST MAIN ROUTINE. 


Figure I-3. Internal Documentation of Program 
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TABLE GENERATION 
The following points describe special statements used to produce documentation. 


e Documentation statements containing cE in columns 1 and 2 cause the page to be 
ejected. 


@ Documentation statements containing cT in columns |] and 2 produce a table. 


The character c preceding an E or T statement is the key character specified by the C 
parameter on the DOCMENT command (the default is an asterisk). . 


The cE and cT statements are recognized only if they appear within a set of consecutive 
statements beginning with ccc (external) .or cc (internal), where c is the key character. 


For example, the statement 


*T EXAMPLE 24/PP PROGRAM, 18/PARAMETER 1, 18/PARAMETER 2 


generates the following table. 


5 4 3 2 1 
987654321098765432109876543210987654321098765432109876543210 


se ee ee ee ne ee oe a a ee ee ee eS SSS ee 


we ew eee ew ee ee ee ew ew a we we ee ee eee 


The bit position header is generated each time a new block of *T statements is 
encountered. The header is not listed for consecutive table statements or for any 
statement containing a nonblank character in column 2% of the first *T statement in a 
block. The identifier EXAMPLE is optional. 


In. the statement format shown, a slash must immediately follow a bit count field; however, 
spaces before the bit count are ignored. All bit. counts for field widths can be specified 
in either octal or decimal. Decimal counts are assumed in the absence of a post radix B. 

All table entry description statements within an *T block represent the same total number 

of bits as the first statement. A maximum table width of 60 bits is allowed. 


The slash separates fields in the table. The bit position that the slash occupies is 
included in the field to its left. Single bit fields are not listed with a slash 
separator. Instead, they have a + below the field position. If only one table entry. is 
listed, the + is listed both above and below the field position. 
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FURTHER CONSIDERATIONS 


All loader control statements (overlay, section, etc.) are considered special, and their 
images are placed with the page number at the foot of each subprogram to which the 
directive applies. 


All END statements are considered special since they terminate a chapter. 


In COMPASS, the first TITLE statement has special meaning. Its contents (if nonblank) 
replace the page header. All subsequent TITLE statements are ignored. 


In COMPASS, the LIST statement has special meaning. The parameters X and L on a COMPASS 
control statement are processed normally. If a -L is encountered, however, all 
documentation is suppressed until a LIST L statment is encountered. If a -X is 


encountered, no documentation is processed on common text CTEXT until a LIST X statement is 
found. 


The maximum number of these LIST statements that can be-processed by DOCMENT is 24. If 


more than 24 LIST X, -X, L, or -L statements are encountered, the following message is 
issued. 


LIST CARD LIMIT - CARD IGNORED. 


The CTEXT and ENDX statements are bracket statements surrounding common text. No 
.documentation is listed unless a LIST X statement is encountered. 


CODING SPECIFICATIONS 


The current NOS coding specifications are contained in a file called CODING. A NOS coding 
standard also exists for SYMPL programs; this standard is contained in a file called 
SYMPCOD.t These files are in 7-bit ASCII format and can be routed directly to an 
upper/lower case ASCII printer or edited using the full screen editor FSE. 


You can convert these files to 6/12-bit display code (for use with some interactive editors 
or for an online manual) using the following commands: 


ATTACH ,pfn/UN=LI BRARY (pfn is either CODING or SYMPCOD) 
FCOPY ,P=pfn,PC=ASCII8 ,N=F ILE2 ,NC=ASCII 
(save, list, or edit FILE2) 


To convert these files to 6-bit display code (for example, if your site has only upper case 
print trains), enter the following commands: 


ATTACH ,pfn/UN=LI BRARY (pfn is either CODING or SYMPCOD) 
FCOPY ,P=pfn,PC=ASC1I8 ,N=FILE2 ,NC=DIS 
(save, list, edit, or route FILE2) 


fThese files are provided to each site; you should check with your site for instructions 
on accessing these files. The following examples assume that your site has saved the 
files as direct access files under user name LIBRARY. 
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MAGNETIC TAPE FORMATS J 


The standard magnetic tapes used are seven-track, 1/2-inch tape and nine-track, 1/2-inch 
tape. Each type of tape can be written in binary or coded (except SI) mode. Unless 
specified otherwise, tapes are assumed to be in binary mode. You can select 200, 556, or 
800 character-per-inch (cpi) density for seven-track tapes, or 800, 1600, or 6250 cpi 
density for nine-track tapes, provided these densities are available with the hardware. 
Tape density can be specified by a LABEL, ASSIGN, or REQUEST command (refer to Volume 3, 


‘System Commands), the LABEL macro (refer to section 4), or an IPRDECK installation option 


(refer to the NOS 2 Analysis Handbook). The system normally performs automatic processing 
of tape parity errors and end-of-tape conditions. However, you can control the processing 
of these functions via the PO keyword on LABEL, ASSIGN, and REQUEST commands, the up and ep 
fields of the FET, (FET+1, bits 45 and.44), or the LABEL macro processing options. 


DATA FORMATS 


Data can be recorded on magnetic tape in any of five formats. 


Format Description 

Tr Internal 

Ss Stranger 

SI binary System internal t 

L Long block stranger 
F Foreign 

LI Long block internal 


The system command user specifies the data format via the F keyword of a LABEL, ASSIGN, or 
REQUEST command. The LABEL macro user specifies the data format via FET+10g, bits 35 
through 30. The following is a description of the physical and logical characteristics of 
each format. You can define maximum block size, end-of-volume conditions, and noise for any 
format via command or FET parameters; the following description of these characteristics 
defines the suggested (and default) values. 


+ NOS/BE system default tape format. 
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| (INTERNAL) FORMAT 
Characteristic 
Header 
Mode 


Block size (PRU size) 


Logical end-of-record 


Logical end-of-file 


Description 
Labeled or unlabeled. 
Binary. 
Actual data block size can range from 0 to 512 (1000g) CM 
words in exact multiples of CM words. All blocks except 


those containing labels include a 48-bit block terminator 
formatted as follows: 


47 35 44 3.0 


[ becom | veskmie «dtd | 


byte count Total number of bytes in the: block 
' including the block terminator. 


block number Number of blocks since the last HDR1 


label. 
in Level number: 
0 End-of-record. 


17g +=End-of-file. 
User-specified frame or character counts have no meaning. 


Any block with fewer than 512 (10003) CM words of data is 
considered a logical end-of-record. During a write 
operation, the level number field of the block terminator 
contains the level number obtained from FET+0, bits 17 
through 14, or the WRITECW macro control word. During read 
operations, the system returns end-of-record status and the 
contents of the block terminator level number field. If the 
level number is 17g, the system also returns end-of-file 
status. Some blocks may consist only of a block terminator. 


Any block consisting of only a block terminator with a level 
number of 17, is considered a logical end-of-file. The 
system ensures that an end-of-record always precedes an end- 
of-file by writing, if necessary, a block consisting only of 
a block terminator with a level number of zero prior to the 
end-of-file. 


Logical end-of-information A tape mark followed by an EOF1 label is considered the end- 


of-information. This trailer sequence is generated by the 
system on labeled and unlabeled I and SI format tapes. The 
system issues a label content error if it encounters a tape 
mark without a valid label following it. 
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Characteristic 


End- of - volume 


Noise 


Special considerations 


S (STRANGER) FORMAT 


Characteristic 
Header 
Mode 


Block size (PRU size) 


Logical end-of-record 


Logical end-of-file 


Logical end-of-information 


End-of - volume 
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Description 


Refer to option 3 under End-Of-Tape/End-Of -Volume 
Conditions. * 


Any block containing fewer than eight frames for seven-track 
tapes or six frames for nine-track tapes is considered noise 
and, therefore, is ignored. 


e All nine-track tapes are written in an even multiple 


of bytes. 


@ On all read operations, the system checks for fill 
status and compares the number of bytes read and the 
block number expected with the byte count and block 
number values in the block terminator. If the 
specified condition does not occur, the system 
handles it as if it were a parity error. This 
method is designed to prevent dropped or fragmented 
blocks; in general, it provides a much higher degree 
of reliability than any other format. 


Description 
Labeled or unlabeled. 
Binary or coded as indicated by FET+0, bit 1. 
No explicit multiple of frames is required. The maximum 


block size may be specified in the mlrs field of FET+6, bits 
17 through 0. If no block size is specified in the mlrs 


. field, it is assumed to be 1000g CM words. The maximum 


block size for S format is 1000g,. 


If the required block is longer than 1000g words, the tape 
should be assigned in L format. 


On a CIO READ (010) or READSKP (020) request, each PRU is 
considered an end-of-record. 


Tape mark. 
If the tape is unlabeled, there is no logical end-of- 
information. If the tape is labeled, the logical end-of- 


information is a tape mark followed by an EOF1 label. 


Refer to option 3 under End-of -Tape/End-of -Volume 
Conditions. 


Characteristic 


Noise 


Special considerations 


SI (SYSTEM INTERNAL) FORMAT 
Characteristic 
Header 


Mode 


Block size (PRU size) 


Logical end-of-record 


Logical end-of-file 
Logical end-of-information 


End-of-reel 


Noise 


Description 


Any block containing fewer than 18 frames is considered 
noise and, therefore, is ignored. 


e@ Level numbers 1 through 16, are interpreted as level 
number 0. 


@ Standard code conversion is performed for seven- or 
nine-track tapes in coded mode. 


@ For CIO READ (010), WRITE (014), WRITER (024), and 
WRITEF (034) functions, a one-block (PRU) operation 
is performed with the unused bit count (FET+6, bits 
24 through 29) taken from and returned to the FET. 


Description 


Labeled or unlabeled. 


Binary as indicated by FET+0, bit 1. If coded mode is set 
on an SI tape, the system aborts the job step. (Refer to 
the TCOPY command description in Volume 3, System Commands, 
for details on reading coded SI tapes.) 


The block size can range from 0 to 512 (1000g) CM words in 
exact multiples of CM words. Any block smaller than the 
Maximum size except those containing labels contain a 48-bit 
block terminator. This terminator has the same format as 
that for I format. 


User-specified frame or character counts have no meaning. 


Any block containing fewer than 512 (1000g) CM words 
represents a logical end-of-record. If a logical record 
consists of an exact multiple of 512 CM words, the block 
that denotes the logical end-of-record consists solely of a 
block terminator. During write operations, the level number 
field of the block terminator contains the level number from 
FET+0, bits 17 through 14, or the WRITBCW macro control 
word. During read operations, the system returns end-of- 
record status and the contents of the block terminator level 
number field. If the level number is 173, the system 
returns end-of-file status. 


Same as for I format. 
Same as for I format. 


Refer to option 3 under End-of-Tape/End-of-Volume 
Conditions. 


Same as for I format. 
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Characteristic 


Special considerations 


Description 


e The system writes all nine-track tapes with 3n+2 . 
¥ mode; that is, the system may write an extra 4 bits 
' to tape in order to preserve the lower 4 bits of a 
CM word. 


® The system does not perform block checking via block 
terminators as is done for I format. 


L (LONG BLOCK STRANGER) FORMAT 


The characteristics and descriptions are the same as for S format tapes except that no 
maximum block size is defined and, if no block size is specified in the mlrs field of FET+6, 
bits 17 through 0, it is assumed to be: 


e@ ULIMIT-FIRST-1 for normal read/write 


@ LIMIT-FIRST-2 for READN/WRITEN 


e@ LIMIT-FIRST-3 for READCW/WRITECW 


F (FOREIGN) FORMAT 
Characteristic 
Label 


Mode 


Block size (PRU size) 


Logical end-of-record 
Logical end-of-file 
Logical end-of-information 


End-of-volume 


Noise 
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Description 
Unlabeled. 


Binary or coded, as needed, for seven-track tapes and binary 
for nine-track tapes. 


The block size cannot. exceed the CM buffer size. No 
explicit multiple of frames is required. The maximum block 
size must be specified at tape request time. The block size 
is used to determine whether to continue read or write ; 
operations based on the amount of data versus the space in 
the buffer. For example, if the maximum block size is 1000, 
CM words, the read operation stops any time that less than 
1001g words remain. The user must specify a buffer size 
equal to the largest block size. 


None. 
Tape mark. 
None. 


Refer to option 3 under End-of-Tape/End-of -Volume 
Conditions. 


Any block containing fewer than 18 frames is considered 
noise and, therefore, is ignored. 


Characteristic 


Special considerations 


Description 


e@ For seven-track tapes, if a parity error is detected 
because the tape is being read in the opposite mode, 
the mode will be switched. 


e F-format operations are done only when using control 
word reads and writes. On read operations, the 


control words are transferred to the user regardless 


of the operation being used. 


Labeled tapes that have been assigned as F format 
will have their labels treated as data. 


LI (LONG BLOCK INTERNAL) FORMAT 


Characteristic 
Header 
Mode 


Block size (PRU size) 


Logical end-of-record 


Logical end-of-file 


Description 
Labeled or unlabeled. 
Binary. 
Actual data block size can range from 0 to 4096 (10000g) CM 
words in exact multiples of CM words. All blocks except 


those containing labels include a 60-bit block prefix 
formatted as follows: 


59 35 1 3°40 


ee 


byte count Total number of bytes in the block — 
including the block terminator. 


block number Number of blocks since the last HDR1 


label. 
in Level number: 
0 End-of-record. 


17g +=End-of-file. 
User-specified frame or character counts have no meaning. 


Any block with fewer than 4096 (100003) CM words of data is 
considered a logical end-of-record. During a write 
operation, the level number field of the block prefix 
contains the level number obtained from FET+0, bits 17 
through 14, or the WRITECW macro control word. During read 
operations, the system returns end-of-record status and the 
contents of the block prefix level number field. If the 
level number is 17g, the system also returns end-of-file 
status. Some blocks may consist only of a block prefix. 


Any block consisting of only a block prefix with a level 
number of 17, is a logical end-of-file. The system ensures 
that an end-of-record always precedes an end-of-file by 
writing, if necessary, a block consisting only of a block 
prefix with a level number of zero prior to the end-of-file. 
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Characteristic Description 


Logical end-of-information A tape mark followed by an EOF1 label is considered the end- 
of-information. This trailer sequence is generated by the 
system on labeled and unlabeled LI format tapes. The system 
issues a label content error if it encounters a tape mark 
without a valid label following it. 


End-of-volume . Refer to option 3 under End-Of-Tape/End-Of-Volume 
Conditions. 
Noise Any block containing fewer than six frames for nine-track 


tapes is considered noise and, therefore, is ignored. 


Special considerations @ All nine-track tapes are written in an even multiple 
of bytes. 


@ On all read operations, the system checks for fill 
status and compares the number of bytes read and the 
block number expected with the byte count and block 
number values in the block prefix. If the specified 
condition does not occur, the system handles it as 
if it were a parity error. This method is designed 
to prevent dropped or fragmented blocks; in general, 
it provides a much higher degree of reliability than 
SI, S, L, or F formats. 


e@ This format is only supported at GE, CE and AE 
densities. 


@ In general, using the LI format results in improved 
transfer rates and total tape capacity over using 
the I format. This is because the block size used 
for LI format (10000g words) is larger than the 
block size used for I format (1000g words). This 
means that much less of the tape is wasted on inter- 
record gaps. However, since the LI format requires 
a CIO buffer of at least 10000g words, some user 
programs and system utilities may not be able to 
read or write tapes in LI format. Increasing the 
size of the CIO buffer(s) in these programs corrects 
the problem. , 


END-OF-TAPE/END-OF-VOLUME CONDITIONS 


The following is a description of the processing options for end-of-tape (EOT) conditions. 
You can select one of these options by default by specifying the data format; by specifying 
an option via the PO keyword on a LABEL, ASSIGN, or REQUEST command; or by specifying the 
LABEL macro processing option field in FET+10g, bits 47 through 45. In addition, the user 
processing bit (FET+1, bit 45) gives the user program control over end-of-volume conditions. 
For further information, refer to the CLOSER, REWIND, and UNLOAD macros described in section 
3. 
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LABEL 
Command Macro 


Option PO Option PO Bit Description 


1 I 47 If, during a write operation, the system 
senses the end-of-tape, it rewrites the 
block on which the ROT occurred as the first 
block on the following volume. No trailer 
information is written on the current 
volume. During a read operation, the block 
on which the EOT occurred is ignored and 
reading continues on the next volume. If a 
tape mark and the EOT are sensed at the same 
time, the BOT is ignored. This option is 
ignored if specified on a CT or AT tape. 


2 P 46 If, during a write operation, the system 
senses the end-of-tape, the system writes a 
trailer sequence, consisting of a tape mark, 
following the block on which the EOT was 
sensed. Any data that occurs following the 
block on which EOT was sensed, yet before 
the tape mark, is ignored. During a read 
operation, the system transfers to the user 
the block on which the EOT was sensed. The 
read operation resumes on the next volume. 
If a tape mark and the EOT are sensed at the 
same time, the EOT is ignored. This option 
is ignored if specified on a CT or AT tape. 


3 s 45 If, during a write operation, the system 
senses the end-of-tape, the system writes a 
trailer sequence following the block on 
which the EOT was sensed. This trailer 
sequence consists of a tape mark followed by 
an EOV1 label for labeled tapes and tape 
marks for unlabeled tapes. The next block 
is written on the next volume. During a 
read operation, the EOT is noted and the 
system transfers to the user the block on 
which the EOT was sensed plus all following 
blocks until a trailer sequence (as 
described above) is recognized. Reading 
resumes on the next volume. 


For options 1 and 2, the system is concerned only with the block on which the EOT is sensed. 
If tapes written using these options are transferred to another system, any data that occurs 
on the volume after this block should be ignored. 


HDR1 LABEL FORMAT 


The format of the HDR1 label is provided here as a reference for the CIO and LFM functions 
decribed in sections 3 and 4. When the HDR1 label is returned to the circular buffer or an 
extended label buffer, it is in this format. For a complete description of each field and 
the formats of other magnetic tape labels, refer to appendix G of Volume 3, System Commands. 


J-8 60459690 K 


file sequence number 


creation date 


file identifier (fi) 
set identification. 
file section number 
(secno) 

file sequence number 
generation number 
gvn 

creation date 


expiration date 


fa 


block count 


system 


reserved 
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File identifier (up to 17 display code characters, left- 
justified with display code blank fill). 


One- to six-character set identification (left-justified 
with display code blank fill). 


One- to four-digit numeric display code file section number 
(right-justified with display code zero fill). 


One- to four-digit numeric display code file sequence number 
(right-justified with display code zero fill). 


One- to four-digit numeric display code generation number 
(right-justified with display code zero fill). 


One- to two-digit numeric display code generation version 
number (right-justified with display code zero fill). 


Creation date (two-digit numeric display code value for the 
year followed by a three-digit numeric display code value 
for the day within the year). 

Expiration date (two-digit numeric display code value for 
the year followed by a three-digit numeric display code 
value for the day within the year). 


One display code character indicating the file accessibility 
to the tape. 


Must be zeros. 


Up to 13 display code characters identifying the operating 
system that recorded this file. : 


Reserved for future use. 
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SHELL PROCESSING L 


“ 


The SHELL command sets controls for a’ command monitoring program. The SHELL command 
includes: 


-@ Name of the shell program. 
e@ Location of shell program (local file, global library, or SYSTEM) « 


e Commands to monitor: commands entered from an interactive terminal, commands 
outside procedures, commands inside procedures. 


e Optional clearing of controls if the shell program aborts. 


The name of the shell program and shell control bits are stored by CPM in word SHCN of your 
Negative field length.. 


When the shell program is called, the current command is passed in CCDR (locations RA+70B 
through RA+77B). If there is no current command (as when you are monitoring commands 
entered from an interactive terminal), RA+70B is zero and the current contents of MSI1W from 
the job’s control point area are passed in ARGR (locations RA+2 through RA+6). 


The shell program may take any action as a result of the command. Specifically, it may 
issue the same or another. NOS command using the EXCST macro. The shell program is not - 
called for commands originated by the SHELL program through the EXCST macro, but is called 
for commands issued by user programs through the EXCST macro. d 


Entering 
SHELL. 


disables shell screening. However, if a shell program is in effect, it may not  oupare you 
to enter the SHELL command, thus preventing you from clearing the shell screening. 


If you want to monitor commands entered from an interactive terminal, your shell program 
must also read commands from the terminal. The system loads your-shell program 
automatically whenever your interactive job is idle (no commands or procedures are 
executing). Your shell program must then read the next command from file INPUT. This 
process circumvents the command syntax processing normally performed by IAFEX and allows 
your shell program to enforce optional Syntax rules. 


Two sample shell programs‘are provided: one written in COMPASS and one written in FORTRAN 5. 


SHELL PROGRAM EXAMPLE USING COMPASS 


The following is an example of a shell program that permits the use of non-NOS syntax 
commands (refer to figure L-1)..- In this example, a simple shell program, SHELDEM, is used 
to permit commands that are longer than seven characters. 


The SHELL command 
SHELL, SHELDEM,G,T. 
causes a global library load (G option) of the shell program SHELDEM to screen commands 


whenever an interactive command (T option) is entered. 
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The valid commands created for this shell example are ASSEMBLER, DOCUMENT, and POE NTA. 
They refer to the procedures CMPSPRC, DOCPROC, and SHELL, respectively. 


Since SHELDEM is loaded at the interactive end-of-job step, there are no values passed to 
CCDR (RA+70B). SHELDEM prompts the user with a time stamp, and ‘then accepts the next 


command entered by the user. The command is processed further by executing a procedure or a 
NOS command associated with the command. 


For brevity, SHELDEM has been kept simple. 
It will not handle commands with leading 
blanks, $ signs, lowercase characters, or 
internal blanks. 
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-PROC, SHELLP*I"DEMONSTRATION OF SHELL" 

«IF, FILECOPL, .NOT.AS) -ATTACH, OPL/UN=LIBRARY. 

. MODIFY, Q, CS=NOSTEXT,Z./*CREATE, SHELDEM/*EDIT, SHELDEM 
LIBEDIT,P=0,B=LGO,U=SHELBIN,N=SHELLIB,I=0. 


LIBRARY, SHELLIB. | 

SHELL, SHELDEM,G,T. 

Xx 

-DATA, SHELDEM 

SHELDEM : 
IDENT SHELDEM,FWA 
ABS 

a _ ENTRY SHELDEM 
ENTRY RFL= 
é@ SYSCOM B1 


ORG 111B 
FWA Ss BSS 0 


*CALL COMCCMD 
*CALL COMCMAC 
*CALL COMSTCM 


IBUFL — EQU 101B TERMINAL INPUT BUFFER LENGTH 
OBUFL EQU.= 101B TERMINAL OUTPUT BUFFER LENGTH 


@ I BSS 0 _ TERMINAL INPUT 


ZZZZZII_ SFILEC §«6IBUF,IBUFL,DTY=2RTT 
0 BSS 0 - TERMINAL OUTPUT 
ZZZZZ00_— FILEC OBUF, OBUFL,DTY=2RTT 


SHELDEM SB1 1 PRESET B1=1 
SHD1 RJ GCI GET COMMAND INPUT 
SA1 CCOR 
ZR X1,SHD3 IF NO. COMMAND 
BX6 x1 : 
: % SA6 CMDSA _ ENSURE COMMAND WILL BE MATCHED 
- SA5 CMDS~1 FWA OF COMMAND TABLE-1 


SA5 A5+B1 

1x3 X5-X1_— 

NZ X3,SHD2 “IF NOT MATCHED 

SX4 AS-CMDSA 

ZR X4,SHD3 IF COMMAND NOT IN TABLE 

RETURN I,R RETURN TERMINAL INPUT FILE 

RETURN O,R RETURN TERMINAL OUTPUT FILE 

EXCST PRCT-CMDS4A5 EXECUTE CORRESPONDING PROCEDURE 


Figure L-1. Shell Program Example Using COMPASS (Sheet 1 of 3) 
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WRITEW 0,SHDA,SHDAL UNKNOWN COMMAND 


EQ 


‘DIS 
Eq 


DATA 

DATA 
DATA 
BSS 


DATA 
DATA 
DATA 


SUBR 
SA1 
NZ 
S-X6 
SA6 
MX6 
LX6 
“SAI 
BX6 
-SA6 


SHD 1 


*-SHDA 


“L*ASSEMBLER* 


L *DOC UMENT * 
L*DO.VE DANYA* 


4 


L*¥CMPS PRC. * 
L*DOCPROC.* 


L*XSHELL.* 


GC IB 
X1,6C11 


B1 


SETLOF GCIC 

RETURN I,R 

‘RETURN 0,R 

REQUEST 1,U,NMSG 
REQUEST 0,U,NMSG 
WRITE 0,* 

PROMPT OFF 

CLOCK CIA 

WRITEW 0,GC-1A,GC IAL 


READ 


I : 


READO ‘I 


ZR 
SX6 
SA6 
EQ 


X1,6C.12 


0 
‘CCDR 


GC IX 


LOOP FOR ANOTHER COMMAND 


-o* SHELDEM - UNKNOWN COMMAND. * 


VALID COMMANDS 


CLEAR SHELL PROCESSING 
RESERVE FOR INPUT COMMAND 


‘PROCEDURES (MUST BE SAME ORDER AS CMDS) 


CLEAR SHELL .PROCESS ING. 


GET COMMAND INPUT 
CHECK IF CALLED BEFORE 


FLAG CALLED BEF ORE 


SET FLUSH BIT -ON OUTPUT | 


SET LIST OF FILES 

RETURN INPUT FILE 

RETURN OUTPUT FILE 

ASSIGN INPUT TO TERMINAL 

ASSIGN OUTPUT TO TERMINAL 
PRESET WRITE CODE FOR IMPLICIT TT OUTPUT 
TURN OFF IAF *?x 

OUTPUT TIME PROMPT 


‘GET COMMAND 


IF NOT (CR) 


Figure L-1. Shell Program Example Using COMPASS (Sheet 2 of 3) 
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BSS 1 ; TIME STAMP FOR INPUT PROMPT 

VFD 12/0L>,48/0L"EB" END OF BLOCK TERMINAL CONTROL 
E@ . *GCIA LENGTH OF TIME STAMP STRING 

CON 0 ZERO IF FIRST TIME IN GCI 

VF D 12/,18/GC1D,30/ LIST OF FILES POINTER 

VFD 1/,41/,18/GCIDL LIST OF FILES 

VFD 42 /0LZZZZZ00, 18/0 

VFD 60/ 

E QU. *-GCID , 


BSS IBUFL “TERMINAL INPUT BUFFER 
BSS OBUFL TERMINAL OUTPUT BUFFER 


“COMCC IO 
COMCC PM 
COMCLFM 
COMCR DO 
COMCSYS 
COM CW TW 


Eq FIELD LENGTH 


Figure L-1. Shell Program Example Using COMPASS (Sheet 3 of 3) 


SHELL PROGRAM EXAMPLE USING FORTRAN 5 


The following is an.example of a shell program that prevents the user from gaining access 
a particular program (in this case, program PAYROLL). In the example shown in figure L-2, 


to 


entering the command PAYROLL causes the shell program to respond with the following message: 


PRIVILEGED PROGRAM. TRY ANOTHER COMMAND. 
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-PROC,SHELLP*I"DEMONSTRATION OF SHELL" 


- IF, FILE COPL,.NOT.AS) ATTACH, OPL/UN=LIBRARY. 
FTNS , I=SHELDEM,L=LIST,X=OPL. 
LIBGEN,P=SHELLIB,N=SHELBIN. 
LIBRARY, SHELLIB. 

SHELL, SHELDEM,G,T. 
REVERT.NOLIST. 


- DATA, SHELDEM. 


Cc 


Figure L-2. 


PROGRAM SHELDEM 


CHARACTER CMD*80 
INTEGER END 


READ(*,'(A)',END=100) CMD 
CALL PERIOD (CMD,END) 


"IF CCMD.EQ."PAYROLL.") THEN 


PRINT *,'PRIVILEGED PROGRAM. 
ELSE 

CALL ZEROFIL(CMD,END) 

CALL EXCCCMD) 
ENDIF 
STOP 


PRINT *,"ENTER A COMMAND.' 


END 
IDENT EXC 
ENTRY EXC 
XTEXT COMCSYS 
XTEXT COMCMAC 
EQ * 
$B1 1 
SA1 A1 
SA5 x1 
EXCST A5 
EQ EXC 
END 


SUBROUTINE ZEROFIL 


CHARACTER CMD*80 
INTEGER END 


DO 10 I=END+1,80 
CMD (I: 1)=CHAR (O) 
CONTINUE 

RETURN 

END 


SUBROUTINE PERIOD (CMD,END) 


Shell Program Example Using FORTRAN 5 (Sheet 1 of 2) 


TRY ANOTHER COMMAND.' 
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CHARACTER CMD*80 
INTEGER END 


DO 10 1=80,1,-1 


IF CCMD(I:I).NE.'. ') THEN 


IF (CMD(I:I).NE.".") THEN 
_ CMD (I4+12141)=".! 
END=I+1 


ELSE 


END=I1 


ENDIF 
GOTO 20 


ENDIF 
CONTINUE 


CONTINUE 
RETURN 
END 


' Figure L-2. Shell Program Example Using FORTRAN 5 (Sheet 2 of 2) 


EXTENDED REPRIEVE PROCESSING M 


An example of the extended reprieve capabilities of RPV is contained in this appendix. 


The COMPASS program shown in figure M-1 illustrates the following. 


@ The SETUP function is used to initialize the parameters for the RPV interface. The 
mask bits are set to intercept terminal interrupts. 

e If no error occurs, a user program will loop until Xl reaches the maximum value. 

e Any error causes branching to error checking. If the error is of the terminal 
interrupt class, the value in the operating error flag is received. If not, 
branching to unhandled errors occurs, and the program aborts. 

e The terminal interrupt error is assumed to be a user break 1 (CTRL-P). The error is 
compared with the user break 1 mask. If the error is not a user break 1, a user 
break 2 is assumed. The error is.then compared with the user break 2 mask. If the 
error is not a user break 2 (CTRL-T)., branching to unhandled errors occurs and the 
program aborts. 

e The type of user break and the value of. Xl at the interrupt is passed to the dayfile. 

e Control returns to the loop program at the point of interrupt and processing resumes. 
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-PROC, TRYRPV*I. 
. HELP 
PGG 9 OS5-AUG-82 TRY OUT EXTENDED REPRIEVE TO DISTINGUISH UB1/UB2. 
. ENDHELP 
REWIND,*. 
. IF, FILE (OPL,.NOT.AS) -ATTACH, OPL /UN=LIBRARY. 
COMPASS, 1=C IN,L=F 1,S=NOSTE XT, S =PSSTE XT. 
L6O. 
.DATA,CIN 
IDENT TRY1 
ENTRY TRY1 
SST SO CAN GET PPTEXT/NOSTEXT SYMBOLS 
SYSCOM B1 


XTEXT COMSRPV 


SB1 1 B1=1 


SET REPRIEVE ON TERMINAL INTERRUPT (S) 


REPRIEVE TIHB, SETUP,/COMSRPV/TIMS 


LOOP UNTIL INTERRUPTED 


BX1 SET X1 TO ZERO 

SX2 

MxO 

ax LOOP UNTIL INTERRUPTED 

BX 

ZR X3, LOOP - IF MAXIMUM VALUE STILL NOT REACHED 
ENDR UN OTHERWISE DONE 


BRANCH HERE ON ANY ERROR 


BSS 0 

MxO 24 

SA1 TIHB+/COMSR PV/ERCL 

LXx1 -12 

Bx1 —X0*X1 GET ERROR CLASS 

SXx1 X1-/COMSRPV/TICL CHECK FOR TERMINAL INTERRUPT 
NZ X1, ABT IF NOT TERMINAL INTERRUPT 

SA1 TIHB+/COMSRPV/ OSEF 

MxO 12 , 

BXx1 ~X0*X1 GET OPERATING SYSTEM ERROR FLAG 
SA3 =C*USR BRK 1 * ASSUME USER BREAK 1 OCCURRED 
SX2 X1-TIET 

ZR X2, TIH1 IF USER BREAK 1 

SA3 =C*USR BRK 2 * OTHERWISE USER BREAK 2 

SX2 X1-TAET 

NZ X2, ABT IF NOT USER BREAK 2 


Figure M-1. Extended Reprieve Example (Sheet 1 of 2) 
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PROCESS TERMINAL INTERRUPT 


0 
X3 WHICH USER BREAK 
TIHA PUT INTO MESSAGE 
TIHX+11B X1 WHEN INTERRUPT OCCURRED 


IHX QUALIFY MESSAGE MACRO 

CDD 
SA6 ~—— TIHA+2 ; 
MESSAGE TIHA,3,R ISSUE DAYFILE MESSAGE ABOUT USER BREAK 
QUAL * 


REPRIEVE TIHB, RESUME,/COMSRPV/TICL CONTINUE ADDING 


DATA H*USR BRK ?2* 
DATA H*X1 VALUE =* 
-BSSZ 2 VALUE AND ZERO FOR MESSAGE ENDING 


BSS 0 UNHANDLED ERROR OCCURRED 
SYSTEM DMD,R,TIHB+/C OMSRPV/REPL, T IHB ; 
ABORT 


RPVBLK TIH,TIHX | TERMINAL INTERRUPT REPRIEVE BLOCK: 


QUAL ——-IHX 

SET 0 FORCE UNQUALIFIED COMMON DECKS 
XTEXT COMCSYS- 

-XTEXT COMCCDD 

QUAL * 


‘END. TRY1 


Figure M-l. Extended Reprieve Example (Sheet 2 of 2) 


Abort C-1 


ABORT macro 11-1 
Absolute assembly C-1 
Access category C-1 
Access level C-1 
Access level limits C-1 
Accessing files 3-7 
Account block C-1 
Accounting information 6-17 
ACTR symbol 1-9; E-2 
Allocatable device C+1 
Alphanumeric C-1 


- ALTER function 3-13 


Alternate 

User accéss 5-4 

User name C-1 : 
ALTERNR function 3-13 
ANSI C-1 
ANSI labels 3-15,46 
APPEND macro 5-30 
ARGR symbol 1-8; E-2 
ASCII 

Defined C-1 

Graphic character sets A-1 

128-character set . A-1 
ASSIGN macro 4-9 
ATTACH macro 5-36 
Auto 

Recall 

Bit 1-3 
Defined C-1 

Auxiliary device C-1 
Auxiliary device requests 5-14 


Backspace status 3-42 
Backspacing a file , 3-42,43,53 
Bibliography K-1 
Binary dump 
Central memory 11-17 
Exchange package 11-17 
Extended memory 11-17 
Binary format 


OPL G-2 
OPLD G-5 
‘PP G-1 
. PROC G-9 
_ TEXT G-9 
ULIB G-7 


Binary formats G-1 
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BKSP macro 3-42 
BKSPRU macro 3-43 


Block Cc-1 
BOI C-1 
Buffer 


Circular 2-1 
Defined Cc-2 
Pointers 2-1 


Byte C-2 


*CALL directive 1-11 
CATLIST macro $-21 
CCAC symbol 5-43 
CCAL symbol 5-44 
CCAP symbol 5-30 
CCAT symbol 5-36 
cCCG symbol 5-38 
cccT symbol 5-21 
CCDF symbol 5-32 
CCDR symbol 1-9; E-3 
CCGT symbol 5-19 
CCOD symbol 5-42 
CCPG symbol 5-20 
CCPM symbol 5-27 
CCRP symbol 5-29 
CCSV symbol 5-15 
Central memory C-2 
Central processor unit c-2 
CHANGE macro 5-38 
Character set 
Anomalies A-2 


ASCII graphic 63-character set 
ASCII graphic 64-character set 
ASCII graphic 95-character set 


ASCII 128-character set A-1 
Batch jobs A-3 
CDC graphic 63-character set 
CDC graphic 64-character set 
Interactive jobs A-3 
Tables A-2 

Checkpoint 
Defined C-2 
File C-2 

CHECKPT macro 10-5 

Checksum C-2 

cIo 
Call format 3-1 
CLOSE function 3-12 
Common decks 3-4 


A-1 
A-1 
A-1 


A-1 
A-1 


Index-1 ] 


Function processing 3-4 
OPEN function 3-12 
Processing options 3-6 
Read functions 3-24 
Request 3-1 : 
Status response codes 3-6 
Write functions 3-33 
CI0= entry point F-10 | 
Circular buffer 2-1; C-2 
CLOCK macro 9-2 
CLOSE macro 3-20 
CLOSER macro 3-23 
Closing a file 3-20 
CMUR symbol 1-9; E-2 
Code set 
Definition A-1 
6-bit display code A-1 
6/12-bit display code A-1 
7-bit ASCII A-1 
Coded mode C-2 
Coding specifications 
Combined input/output 
Command record C-2 
Comment field I-2 
Common decks 
Available to user F-1 


WH 
toe 
0 


cro 3-4 
COMCARG F-8 
COMCARM F-8 
COMCCDD F-8 
COMCCFD F-8 
COMCCHD F-8 
COMCCIO F-8,10 
COMCCMD F-7 
COMCCOD F-8 
COMCCPA F-8 
COMCCPM F-8,10 
COMCCPT F-8 
COMCCVI F-8 
COMCCVL F-8 
COMCDCM F-8 
COMCDCP F-8 
COMCDXB F-8 
COMCECM D-1; F-9 
COMCECS D-1; F-9,11 
COMCEDT F-9 
COMCFCE F-9 
COMCGTO F-9 
COMCHXB F-9 
COMCLFM F-9,11 
COMCLOD F-9 
COMCMAC F-5 
COMCMTM F-9 
COMCMTP F-9 
COMCMVE F-9,11 
COMCOVL F-9,11 
COMCPFM F-9,11 
COMCPOP F-9 

| Index-2 


COMCRDC 
COMCRDH 
COMCRDO 
COMCRDS 
COMCRDW 
COMCRSP 
COMCSFM 
COMCSFN 
COMCSNM 
COMCSRT 
COMCSSN 
COMCSST 
COMCSTF  F-10 
COMCSYS F-10,11 
COMCUPC F-10 
COMCUSB - F-10 
COMCVDT F-10 
COMCVLC F-10 
CoMcWwOD - F-10 
COMCWrc = F-10,11 
COMCWIH F-10,11 
COMCWTO F-10,11 
COMCWIS F-10,11 
COMCWIW F-10,11 
COMCZAP F-10 
COMCZTB F-10 
COMSPFM 5-1,10 
cpu 1-9 


t 4 
Paar 
PR 


° 


i] 
° 


) 
PrRrRMWoOUWUW HY www 


oo°o 


=y 
PREP Pp 


i i 


Data transfer macros 3-58 


Defined C-2 
Format 1-10 
LFM 4-1 
PFM 5-1 
Relocatable F-10 
Usage 1-9 
Compare/move unit C-2 
COMPASS C-2 
Compressed compile file format 
Concatenation symbol A-4 
Control 
Program execution 12-19 
Words S-2 
Control byte 12-7; C-2 
Auto input 12-7 
End-of-block 12-7 
End-of-line 12-7 
End-of-string 12-11 


Executive auto input 12-14 
Initiate ASCII input 12-8 


G-10 & 


Initiate ASCII output 12-11 


Initiate transparent input 


Initiate transparent output 


12-8 
12-9 


Internal end-of-block 12-11 


Log off user 12-8 
Terminal redefinition 
NAM/CCP 12-14 
NAM/CDCNET 12-10 
CONTROL macro 10-2 
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‘ 


Control point C-3 = j me | sty Job status codes. E-6 
Control point manager (CPM) 6-1 °° Scheduling data field &E-7 
Conversion mode C-3 = id ‘ Empty PRU/record C-4 
Conversion, of programs 12-4.1 ‘ ENCSF macro 4-10 
CPCOM F-1 sos ee End-of-file C-4 
CPM 4 fe End-of-information ' C-4 

Call format 6-1 7 eS ah End-of-line C-4 

Common decks 6-1 © =» ~*~. °°" End-of-record C-4 
CPM= entry point F-10 - : _ End-of-volume J-7 . 
CPU common decks F-1 - | oa * End-of-tape C-4 
CSET macro 11-31 oo End-of-tape processing J-7 
CSMR symbol 1-9; E-3 — a : ENDRUN macro 11-5 
CSTATUS macro 6-42 : Entry point C-4 _ - 
CTEXT pseudoinstruction 1-12 _ EOF1 label 3-21,22 - - , 
CYBER loader C-3 ce EOV1 label 3-22,23 
CYBER record manager . : EOV2 label 3-23 

@ Defined C-3 : tag Equipment access levels C-4 


I/O 3-62 =" is Pe Equipment code C-4 
Sink Equipment status table C-4 
; Forel BREXIT macro 6-5 ; 
DAS C-3 aa i ERJS symbol 8-7 


Data et a Ae . ; Error 
Format J-1 : bi, Codes 
Space 2-3 ve eas CIO 3-2 
Transfer macros 3-54 — LFM 4-2 

DATE macro 9-2 cnt es PFM 5-4 

Dayfile C-3 a RPV 10-14 

@ DAYFILE macro 11-1 : Flag £E-11 

DCB= entry point F-11: ° Messages B-1 

Default . : : Special E-12 
Defined C-3 : Error processing 7-10 
File assignments 12-4.1 -° EST ordinal C-4 
Service classes E-9 ETIME macro 9-4 

DEFINE macro 5-32 EVICT macro 3-51 

Device type C-3; E-10 Evicting a file 3-51 

Diagnostic messages B-1 ; Exchange jump instruction 1-1,5; C-4.1 

Direct access files C-3 , Exchange package C-5; E-4,5 

Disk Array Subsystem C-3- : EXCST macro 10-5 

eS Display code c-3 _ a Exit mode c-5 

Display mode 11-29 EXJS symbol E-6 

Dispose processor (DSP) 7-1 Extended 

Disposition code c-3 : : Core storage c-5 

DISTC macro 11-29 ; Label processing 3-17,47; C-5 

DOCMENT command I-1 - phe: UB oe Large central memory C-8 

DOJS symbol E-7 a : Memory 

DSP call format 7-1 ae Defined C-5 

DTCS symbol E-6 ; eR Transfers D-1 

‘Dump oh, Oat Semiconductor memory C-5 

Central memory 11-19 . Extended reprieve processing M-1 
Extended memory 11-16 fe? External reference C-5- 
Requests 11-16 ‘ ; 

ECSTEXT 1-6; D-2 ; ead Se F format tape J-5 

EDATE macro 9-3 Pony EE Sete ga Ao Family device C-5 

EFFECT macro 11-35" ad Fast dynamic loader C-5 | 

EUT iy ee ome FET : 
Connection status codes E-6 , Creation macros 2-14 
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Description 2-4 
Formats 


CIO requests 3-2 
LFM requests 4-1 
PFM requests 5-1 


Standard 2-4 
Label macro 4-11 3 
Modification macro 2-17 
Pointers 12-5 
Field length Cc-5 : 
Field length extended C-5 
File ee 
Access category C-6 
Access level C-6 | 
Backspacing 3-42,43,54 
Defined c-5 
Environment table C-6 
Flushing C-6 
Name table C-6 ; 
Name table word C-6 
Overwriting 3-40 / 
Positioning functions 3-42 
Purging 5-20 
Random C-11 ; 
Random access 3-7 
Reading 3-8.1 
Returning 3-45 
Rewinding 3-43 
Routing 7-1 
Saving 5-15 
Sequential access 3-7 
Set C-6 
Skipping 3-52 : 
Space, releasing 3-45,51 
Status table word C-6 
Types E~8 
Utility table word C-7 
Writing 3-8.1 
File environment table 2-1 
FILEB macro 2-14 
FILEC macro 2-14 
FILINFO macro 4-26 
FIRST address 2-2 
Flag C-7 
Foreign format tape J-5 
Foreign tape Cc-7 
Format, magnetic tape J-1 
Frame Cc-7 
Full track C-7 
Function Processors 1-1; C-7 
Functions : 
ALTER 3-13 
ALTERNR 3-13 
IRESUME 10-8 
NR 3-13,20 
READ 3-13 
READNR 3-13 
REEL 3-13 


ff tnaex-4 


Generation C-7 
GET macro 5-19 
GETACT macro, 6-25 
GETASL macro 6-11 
GETCN macro 6-41 
GETEM macro 6-11, 
GETFLC macro 6-19 
GETFNT macro 4-18 
GETGLS macro 6-23 
GETJA macro 6-17 
GETJAL macro 6-35 
GETJCI macro 6-29 
GETJCR macro 6-15 
GETJN macro 6-10. 
GETJO macro 6-17 
GETJOSC macro 6-33 


_ GETISL macro 6-12 


GETLC macro 6-23 _ 
GETLIDA macro 11-5 
GETLOF macro 6-28 
GETLVL macro 6-40 
GETMC macro 11-7 
GETPAGE macro 6-39 
GETPFP macro 6-27 
GETPR macro 6-10 
GETRI macro 6-40 
GETSCH macro 6-42 
GETSS macro 6-21 
GETSSID macro 6-32 


_ GETSSM macro 11-8 


GETTL macro 6-12 
GETUSC macro 6-36 
Global library. set C-7 


Half track C-7 

HDR1 label 3-16,46 
HDR1 label format J-8 
HTIME macro 9-5. 


I format tape J-2 
IN address 2-2 
Indirect access files C-7 
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Input file type C-7 
Interactive . 
Programs 12-4.1; C-7~ 


Terminal requests 11-29 oe 


Internal format tape © J-2 
Interrecord gap C-7 
Interrupt c-8 

IoJS symbol E-7 


JDATE macro 9-5 

Job : 
Access category set c-8 
Access level C-8:° 
Access level limits "‘C-8 


Communication area E-1-~ 


Control 10-1 
Step c-8 
JOPR symbol 1-9; E-3° 


L format tape J-5 

Label Cc-8 

Label buffer . 3-17,47°° 

LABEL macro 4-11 #4“ 

Label processing 
Extended 3-17,47.. 
Standard 3-15,46 


Large central memory extended” C-8__ 


LCB= entry point F-11 
LDRR symbol 1-9; E-3 
Level designator C-8 
Level number c-8 
LFM ; 
Call format 4-1 © 
Common-decks 4-1") 
Error codes 4-2 
Request 4-1 
LFM= entry point F-11 
LI format tape J-6 : 
Library file C-8 1 
LIMIT address 2-2. ‘ 
Line C-8 . 
LINP symbol 1-9 ae 
List of files c-3 


LIST pseudoinstruction © 1-127 


Load point c-9 

LOADD macro 11-24 . 
Loader requests 11-20 
LOADQ macro 11-26 

Local file cC-9 a 


Local file manager (LFM) . 4-1 


Local file name c-9 
Local file name table C-9 
LOCK macro 4-4 

Locked file 4-4; C-9 
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Logical identifier 


Logical record 


c-9 
Cc-9 


Long block stranger format tape J-5 


LWPR symbol 1-9; E-2 
MACHID macro 6-25 
Macro C-9  ~ * 
“ABORT If-1 ‘ 

APPEND 5-30 

ASSIGN 4-9 

ATTACH 5-36 

BKSP 3-42 

BKSPRU 3-43° ye 

CATLIST 5-21°° 

CHANGE 5-38 °° 

CHECKPT 10-5. 

CLOCK 922° 

CLOSE 3-20 

CLOSER 3-23 

CONTROL 10-2 

CSET 11-31 7 

CSTATUS 6-42 

DATE 9-2 

DAYFILE 11-1 = 

DEFINE 5-32 

DISTC’ 11-29 

EDATE 9-3 

EFFECT 11-35 

ENCSF 4-10 

ENDRUN 11-5 

EREXIT 6-5 

ETIME 9-4 

EVICT 3-51 

EXCST 10-5 

FILEB 2°14 

FILEC 2-14 

FILINFO 4-26 °°” : 

GET 5-19 

GETACT -6-25 an 

GETASL 6-11 

GETCN 6-41 

GETEM 6-11 m 

GETFLC 6-19 

GETFNT 4-18 

GETGLS 6-23 

GETIA 6-17 

GETJAL 6-35 

GETICI 6-29 

GETICR 6-15 

GETIN 6-10: 

GETJO 6-17 

GETIJOSC 6-33 

GETJSL - 6-12 

GETLC 6-23 

GETLIDA 11-5 ; 

GETLOF 6-28 


Index-5 | 


GETLVL 6-40 
GETMC 11-7 
GETPAGE 6-39 
GETPFP 6-27 
GETPR 6-10 
GETRI 6-40 
GETSCH 6-42 
GETSS 6-21 
GETSSID 6-32 
GETSSM 11-8 
‘GETTL 6-12 
GETUSC 6-36 
HTIME 9-5 
JDATE 9-5 
LABEL 4-11 ~- 
LOADD 11-24 
LOADQ 11-26 
LOCK 4-4 
MACHID 6-25 
MEMORY 11-9 
MESSAGE 11-10 
MODE 6-2 

MOVE 11-12 
NORERON 11-20 
OFFSW 6-9-0 
OLD 5-42 

ONSW 6-9 

OPEN 3-13 
OVERLAY 11-21 
OVWRITE 3-40 


PACKNAM (035) 
PACKNAM (036) 


PDATE 9-6 -*- 
PERMIT 5-27 
POSMP 3-46 
PRIMARY 4-26 
PROMPT 11-31 
PROTECT 6-31 
PSCSF 4-10° 
PURGE 5-20 
READ 3-25 
READC 3-58 
READCW 3-27 
READEI 3-33 
READH 3-59 
READLS 3-29 
READN 3-32 
READNS 3-31 
READO 3-60 
READS 3-60 
READSKP 3-26 
READW 3-61 
RECALL 11-13 
RENAME 4-2 
REPLACE 5-29~ 
REPRIEVE 10-15° 


REQUEST (014) 
REQUEST (015) 


RERUN 


: | Index-6 


11-20 


RETURN 3-45 
REWIND 3-43 
REWRITE 3-38 
REWRITEF 3-33 
REWRITER 3-39 
RFILEB 2-14 
RFILEC 2-15 
ROLLOUT 6-7 
ROUTE 7-8 
RPHR 3-25 
RPHRLS 3-30 
RPVBLK 10-10 
RTIME °<9-6 
SAVE 5-15 
SETASL 6-3 
SETFAL 4-3 
SETFET 2-17 
SETFS 4-3 
SETGLS 6-24 
SETJAL 6-35 
SETJCI 6-30 
SETIJCR 6-16 
SETJOB 6-31 
SETJSL 6-4 
SETLC 6-13 
SETLOF 6-28 
SETMFL 6-27 


SETPAGE 6-39 
SETPFAC 5-43 
SETPFAL 5-44 


SETPR 6-1 
SETRFL 6-14 
SETSC, 6-38 
SETSHC 6-33. 
SETSIM 11-32 
SETSS 6-16 
SETSSM 6-8 
SETTL 6-4 
SHELL 6-33 
SKIPB 3-53 
SKIPEI 3-53 
SKIPP 3-52 
SKIPFB 3-54 
SKIPFF 3-52 
STATUS (012) 
STATUS (013) 
STIME 9-7 
SUBR 11-13 
SYSCOM 1-8 
SYSTEM 11-14 
TIME 9-7 
TSTATUS 11-33 
UNLOAD 3-44 
UNLOCK 4-4°° 
USECPU 6518 | 


USERNUM 6-18 
VERSION 6-22 


WAIT 
WPHR 


11-15 
3-34 


- 


Pe es 
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Macro Usage 1-7 ae A Sea 
Magnetic tape files 


Mass storage files 


Mass storage operations 
Memory allocation for oyeEtey Ones 1l- 


28 


MVE= entry point F-11 


Network c-9 : 
Network terminal Cc-9 

NICS symbol E-6 scarey 
Nonallocatable device C-9. = 
Nonstandard tape label .-C-9:, 
NORERUN macro 11-20 “oS, 
NOS Systems Texts 


MEMORY macro 11-9 an a 
MESSAGE macro . 11-10 
Messages B-1 

MLRS 
MODE macro 6-2 ot 
MOVE macro 11-12 : 
MSG= entry point F-11.. | 
Multifile 4 yee 


WRITE 3-34 2G 
WRITEC 3-59 ; 
WRITECW 3-36 

WRITEF 3-35 | 

WRITEH 3-59 a 
WRITEN 3-41 Bie; 
WRITEO 3-60 Be 
WRITER 3-35 \ 
WRITES 3-61 

WRITEW 3-61 


ANSI standard labeled. 13415 
Evicting 3-51 : 
Formats J-1 
Labeling 3-15 er: 
Multifile set 3-46-°: 
Nonstandard labeled 
Returning 3-45 
Rewinding 3-43 
Standard FET 2-5 
Unlabeled 3-15 
Unloading 3-44 


Assignment 4-6,7 
Closing 3-20, 
Evicting 3-51 
Overwriting 3-40 
Returning 3-45 
Rewinding 3-43 
Standard FET 2-4 
Unloading 3-44 


3- 1 at 93 


S o 


c-9 ramen 


File c-9 Se 
Set 3-46; C-9 <:.. eae 
Tape, positioning . 3-46: 


ECSTEXT 1-6 Sagaks 
NOSTEXT 1-6 gees 
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PPTEXT 1-6° 
PSSTEXT 1-6 
SYSTEXT 1-6 
NOSTEXT 1-6 
NOSVER micro 1-6 
NPC= entry point 12-2 
NR function 3-13,20,23 
NvJS symbol E-7 


OFFSW macro 6-9 
OLCS symbol E-6 
OLD macro. 5-42 a 
Old program library: C-9 . 
ONSW macro 6-9 re 8 
Opdef C-10 ; 2 
OPEN macro 3-13 


Opening a file 3-13 


Origin types E-8 ee 
OUT address . 2-2 ard 


‘Overlay C-10 ate 
Overlay loaders. 11-28 ey 


OVERLAY macro 12-210 “het 


Overwriting file space 3-40: 


OVL= entry point F-i1l 
OVWRITE macro 3-40 


Pack name c-10 

PACKNAM (035) macro 6-20 
PACKNAM (036) macro 6-21 
Parameter C-10_ 
Parameter processing 12-1:. 
Parity C-10 ait 
Password Cc-10° : 
PDATE macro 9-6 ; hs 
Peripheral processor ~C-10- 


Permanent file See ers 


Catalog C-10 

Defined C-10 : 

Family: C-10 sD 
Permanent file manager (PFM) - 
PERMIT macro 5-27 
PFM 

Call format. 5-1 

Common decks 5-1 

Error codes 5-4 ; 

Parameters 5-10 aes 

Request 5-1 : 
PFM= entry point F-11, 
PGNR symbol 1-9; E-2 
Physical record C-10 ‘ 
Physical record unit, C-10-; 
Positioning a file 3-42 
POSMF macro 3-46 & ; ted 
PPTEXT 1-6 ts 


Index-7. | 


Preserved file c-10 
Primary file C-11 
PRIMARY macro 4-26 
Print file C-11 
Print trains A-4 td es ; 
Private auxiliary device C-11 
PRJS symbol E-6 ~” 7 ee 
Program 
Control: of “execution 22219 «, 
Control of terminal activity,. 712- -6 
Conversion 12-4.1 7° || _ 
Documentation I-1 * 
Library C-11 ete 
Library directory format, .G-5 
Special handling 13: 5. 0° 
Standards I-1 
PROMPT macro 11-31 
PROTECT macro 6-31 
PRU device C-11 ~ 
PSCSF macro 4-10 a 
Pseudoinstruction. .C-11,.. 
PSSTEXT 1-6 ve ee 
Public auxiliary device ~ ¢ 
Punch file C-11 ae 
PURGE macro 5-20 Sie 
Purging files 5-20 ~~ 
PWIS symbol E-7 poy 


eac 
ALTER request . 8-12. 
Call format ‘8-1 
Error ‘codes 8-2 oe eS 
GET request 6-14 ©  . .. 
Parameter block 8-1. 
PEEK reply bleck | . 8- ig” 
PEEK request 8- ‘16 
Request 8-1,10.. 
QUAL pseudoinstruction L-13, a 
Qualified symbol C-11 00 ny 
Queue file manager (QFM)  11- cane 
Queue access. interface {Qac) }- ‘ 
Queued file table ~ ¢- 11. 


RA.CEJ symbol 1-9 
RA.CMU symbol 1-9 
RA.MTR symbol 1-8 
Random eee 
Access 3-7; C-11 
Address C-11 
File C-11 
File, sample H-1 
I/O, examples /H-1..; 
Request 3-10. , 
RA+1 requests, - issuing. “1 


| Index- 8 


RCL= entry point F-11 
RDC= entry point P-11 
RDH= entry point F-11, 
RDO= entry point F-1l1.. : 
RDS= entry point = F-11... 
RDW= entry point F-11 
RDX= entry point F-11 
READ function 3-13 

Read functions 3-24 <:.: 
READ macro 3-25. 


. Read/write extended memory D-1 


READC macro 3-58 


* READCW macro 3-27 


READEI macro 3-33 
READH macro 3-59 
READLS macro 3-29 
READN macro 3-32 
READNR function 3-13 
READNS macro -3-31 = 3.0: 


. READO macro 3-60 


READS macro. 3-60 
READSKP macro 3-26 3 .. 
READW macro 3-61 .. 45 ma 
REC= entry point F-il - 
Recall C-il : LT le 
RECALL macro 11-13. 
Record ee 7 
Defined C-12 £3 
Separator: C-12 
Skipping 3-52 
Reel See Volume, -; 
REEL function 3-13. 
REELNR function 3-13 
Reference address C-12.- 
Register C-12 me” 
Relative address C-12 -:. 
Relocatable assembly C-12. 
Removable device C-12 
RENAME macro 4-2 
Renaming a file 4-2 ae 
REPLACE macro 5-29 ee 
REPRIEVE macro 10-15 -: 
Reprieve processing 10-8; 12-21 
Request, system 1-2 Lb 
REQUEST (014) macro 4-6 
REQUEST (015) macro 4-7: 
RERUN macro 11-20 4 
RETURN function 3-20,23:: 
RETURN macro 3-45 wt 
Returning a tape file 3-45 
REWIND function 3-20 
REWIND macro 3-43 
Rewinding a file 3-43 
REWRITE macro 3-38 
REWRITEF macro 3-39 
REWRITER macro 3-39 # 
RFILEB macro 2-14 
RFILEC macro 2-15 
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“ROIS symbol E-6 if” 


Rollout C-12 
Rollout file C-12 a 
ROLLOUT macro 6-7 - 
Rotating mass storage” 
ROUTE macro 7-8 
RPHR macro 3-25 
RPHRLS macro 3-30 i 
RPVBLK macro 10-10.:"-°% 
RTIME macro 9-6 


S format tape J-3 
SABRE C-12 

SAVE macro. 5-15 ; 
Sector’ C-12 ‘ 
Secured system C-12 


CIO processing 3-12, oe 


Security administrator ./ 
Security count C-13 

Security unlock status. 
Sense switches C-13° =: 


Sequential access C-13 =. + 
4 


Sequential file C-13 
Service class, default 
Service class types E+9 
Set, magnetic tape 3-46 


SETASL macro 6-3 : % ee 


SETFAL macro 4-3 


SETFET macro 2-17 Raed 


SETFET parameter processing 
SETFS macro 4-3 . 
SETGLS macro 6-24 
SETJAL macro 6-35; 
SETJCI macro 6-30 
SETJCR macro 6-16 
SETJOB macro 6-31° 
SETUJSL macro 6-400 ee 
SETLC macro 6-13 
SETLOF macro 6-28 
SETMFL macro 6-27 
SETPAGE macro 6-39 
SETPFAC macro  5~43': 
SETPFAL macro 5-44 
SETPR macro 6-1 >"? 
SETRFL macro 6-14 } 
SETSC macro . 6-38 : 
SETSHC marco 6-33'%-.°°* 
SETSLM macro 11-32 
SETSS macro 6-16 
SETSSM macro 6-8 
SETTL macro 6-4 
SHELL macro 6-33 


Shell processing L-1 **- Q 


Short PRO C-i3 

SI format tape J-4 
SIJS symbol E-6 
SKIPB macro 3-53 
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SKIPEI macro 3-53 , 
SKIPF macro 3-52 
SKIPFB. macro 3-54 
SKIPFF macro 3-52 :.- 
SOJS symbol E-6 
Solid State Disk ‘€-13°~ ; 
Special ~ 
Entry points 


a 


User information .* 
SPPR symbol 1-8 
SSD C-13 : ; 
Standard labeled tape ‘¢: i3 
STATUS (012) macro 
STATUS (013) macro 
STIME macro 9-7 
Stranger format tape” “J-3° 
Stranger tape C-13 
SUBR macro 11-13 ~"" 
SUJS symbol E-7 
SWJS symbol E-7 
Symbol C-13 
SYS= entry point . F-11 
SYSCOM macro 1-8 
SYSLIB' F-10 
System 

Access oa od 

Category set ‘ 
Levels c-14 

Communication symbols, 

File C-14 : 

File name table | “oe 14 

Labeled tape ~C-14 “"" 

Library C-14 ei : 

Request 1-1; 9-1;,¢ 

Processing 

Resource unit C- 

Text 1-6; c-14 ° 
System internal format tape 
SYSTEM macro - 11-14' . 
SYSTEXT 1-6 


t 


4-4 
4-5 


a 


Tape 
Format C-14 
Mark C-14 . 
Standard labeled C-13 | 
Stranger C-13 “a 

Temporary file C-14 

Terminal 

Attributes eta 
Mapping 12-18.1 | 
NAM/CCP 3 ‘12- 15, 16; 
NAM/CDCNET™ 12° 12, 43 

Control keys 12-19 

Redefinition 


mas 


Index-§ | . 


NAM/CCP 12-14 

NAM/CDCNET 12-10 
Terminal files 

Standard FET 2-4 

TIME macro 9-7 
Time slice c-14 
Timed/event rollout C-14 
TOJS symbol  &-7 


Translate control statement (TCS) 


TSTATUS macro 11-33 


. UHL label. 3-18 


Unified extended memory C-14 
Unlabeled tape C-14 
UNLOAD function 3-20,23 
UNLOAD macro 3-44 
UNLOCK macro 4-4 
Unprintable characters A-4 
Unsecured system c-15 
USECPU macro 6-18 
User 
Header label 3-18 
Index C-15 
Library group format G-7 
Trailer label 3-22 
Volume label 3-18 
User breaks 12-21 
USERNUM macro 6-18 
UVL label 3-18 


Validation file C-15 
VERSION macro 6-22 

Volume c-15 

Volume serial number c-15 
VOL1 label 3-18 


cro 11-15 
WECSéntry point 


hee 


WNB= entry point F-11 
Word ¢c-15 . 
WPHR macro 3-34 
WRITE function 3-13 
Write lockout bit 4-4 
WRITE macro 3-34 
Write ring C-15 
WRITEC macro 3-59 
WRITECW macro 3-36 
WRITEF macro 3-35 
WRITEH macro 3-59 
WRITEN macro 3-41 
WRITENR function 3-13 
WRITEO macro 3-60 
WRITER macro 3-35 
WRITES macro 3-61 
WRITEW macro 3-61 
Writing programs 
Interactive 12-4. 
NOS 12-1 
WIC= entry point F-11 
WTH= entry point F-11 
= entry point F-11 
WTS= entry point F-11 
WIW= entry point F-11 
= entry point F-1i1 


XJ instruction 1-2,5 
XJPR symbol 1-9; E-3 
XTEXT pseudoinstruction 


Zero-byte terminator 
Zero-length PRU C-15 
ZZZDUMP file 11-16 
ZZZZDMB file 11-17 


63-character set A-1 
64-character set A-1 
95-character set A-1 


1 


c-15 
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Comments (continued from other side) ._ 
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We would like your comments on this manual to help us improve it. Please take a few minutes to fill out 
this form. 


Who are you? How do you use this manual? ae 
CL) Manager OO As an overview 

[ Systems analyst or programmer O) To learn the product or system 

0 Applications programmer : CO For comprehensive reference 

LC Operator 0 For quick look-up 

[J Other (] Other : 


What programming languages do you use? 
i ee ee ee 


See 
How do you like this manual? Answer the questions that apply. 

Yes Somewhat No 

Does it tell you what you need to know about the topic? 

Is the technical information accurate? 

Is it easy to understand? 

Is the order of topics logical? 

Can you easily find what you want? 

Are there enough examples? 

Are the examples helpful? ((] Too simple? [] Too complex?) 
Do the illustrations help you? 

Is the manual easy to read (print size, page layout, and so on)? 
Do you use this manual frequently? 


Comments? If applicable, note page and paragraph. Use other side if needed. 


NOOOOOO00o0o 
OOOOo0oo0o0oo0o00 
OOOO000000 


Check here if you want a reply: [1] 


Name : Company 


Address Date 


Phone 


se ew 2 
Please send program listing and output if applicable to your comment. 


